home *** CD-ROM | disk | FTP | other *** search
| Texinfo Document | 1993-11-19 | 31.1 KB |
open in: 
MacOS 8.1
|
Win98
|
DOS
view JSON data
|
view as text
This file was processed as: Texinfo Document
(document/texInfo).
You can browse this item here: FlexCat_english.texinfo
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 100%
| dexvert
| Texinfo Document (document/texInfo)
| magic
| Supported |
| 1%
| dexvert
| Text File (text/txt)
| fallback
| Supported |
| 100%
| file
| TeX document, ASCII text
| default
| |
| 100%
| checkBytes
| Printable ASCII
| default
| |
| 100%
| perlTextCheck
| Likely Text (Perl)
| default
| |
| 100%
| siegfried
| x-fmt/111 Plain Text File
| default
| |
| 100%
| detectItEasy
| Format: plain text[LF]
| default (weak)
|
|
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 69 6e 70 75 74 20 61 | 6d 69 67 61 74 65 78 69 |\input a|migatexi|
|00000010| 6e 66 6f 0a 5c 69 6e 70 | 75 74 20 74 65 78 69 6e |nfo.\inp|ut texin|
|00000020| 66 6f 0a 40 63 20 25 2a | 2a 73 74 61 72 74 20 6f |fo.@c %*|*start o|
|00000030| 66 20 68 65 61 64 65 72 | 0a 40 73 65 74 66 69 6c |f header|.@setfil|
|00000040| 65 6e 61 6d 65 20 46 6c | 65 78 43 61 74 5f 65 6e |ename Fl|exCat_en|
|00000050| 67 6c 69 73 68 2e 67 75 | 69 64 65 0a 40 73 65 74 |glish.gu|ide.@set|
|00000060| 74 69 74 6c 65 20 46 6c | 65 78 43 61 74 20 40 76 |title Fl|exCat @v|
|00000070| 61 6c 75 65 7b 56 45 52 | 53 49 4f 4e 7d 20 20 20 |alue{VER|SION} |
|00000080| 20 44 6f 63 75 6d 65 6e | 74 61 74 69 6f 6e 0a 40 | Documen|tation.@|
|00000090| 73 65 74 63 68 61 70 74 | 65 72 6e 65 77 70 61 67 |setchapt|ernewpag|
|000000a0| 65 20 6f 66 66 0a 0a 40 | 63 0a 40 63 20 20 46 6c |e off..@|c.@c Fl|
|000000b0| 65 78 43 61 74 3a 09 09 | 20 20 20 20 54 68 65 20 |exCat:..| The |
|000000c0| 66 6c 65 78 69 62 6c 65 | 20 63 61 74 61 6c 6f 67 |flexible| catalog|
|000000d0| 20 67 65 6e 65 72 61 74 | 6f 72 09 20 20 20 20 56 | generat|or. V|
|000000e0| 31 2e 30 31 0a 40 63 20 | 20 43 6f 70 79 72 69 67 |1.01.@c | Copyrig|
|000000f0| 68 74 20 28 43 29 20 20 | 20 31 39 39 33 20 20 20 |ht (C) | 1993 |
|00000100| 20 4a 6f 63 68 65 6e 20 | 57 69 65 64 6d 61 6e 6e | Jochen |Wiedmann|
|00000110| 0a 40 63 0a 40 63 20 20 | 54 68 69 73 20 70 72 6f |.@c.@c |This pro|
|00000120| 67 72 61 6d 20 69 73 20 | 66 72 65 65 20 73 6f 66 |gram is |free sof|
|00000130| 74 77 61 72 65 3b 20 79 | 6f 75 20 63 61 6e 20 72 |tware; y|ou can r|
|00000140| 65 64 69 73 74 72 69 62 | 75 74 65 20 69 74 20 61 |edistrib|ute it a|
|00000150| 6e 64 2f 6f 72 20 6d 6f | 64 69 66 79 0a 40 63 20 |nd/or mo|dify.@c |
|00000160| 20 69 74 20 75 6e 64 65 | 72 20 74 68 65 20 74 65 | it unde|r the te|
|00000170| 72 6d 73 20 6f 66 20 74 | 68 65 20 47 4e 55 20 47 |rms of t|he GNU G|
|00000180| 65 6e 65 72 61 6c 20 50 | 75 62 6c 69 63 20 4c 69 |eneral P|ublic Li|
|00000190| 63 65 6e 73 65 20 61 73 | 20 70 75 62 6c 69 73 68 |cense as| publish|
|000001a0| 65 64 20 62 79 0a 40 63 | 20 20 74 68 65 20 46 72 |ed by.@c| the Fr|
|000001b0| 65 65 20 53 6f 66 74 77 | 61 72 65 20 46 6f 75 6e |ee Softw|are Foun|
|000001c0| 64 61 74 69 6f 6e 3b 20 | 65 69 74 68 65 72 20 76 |dation; |either v|
|000001d0| 65 72 73 69 6f 6e 20 32 | 20 6f 66 20 74 68 65 20 |ersion 2| of the |
|000001e0| 4c 69 63 65 6e 73 65 2c | 20 6f 72 0a 40 63 20 20 |License,| or.@c |
|000001f0| 28 61 74 20 79 6f 75 72 | 20 6f 70 74 69 6f 6e 29 |(at your| option)|
|00000200| 20 61 6e 79 20 6c 61 74 | 65 72 20 76 65 72 73 69 | any lat|er versi|
|00000210| 6f 6e 2e 0a 40 63 0a 40 | 63 20 20 54 68 69 73 20 |on..@c.@|c This |
|00000220| 70 72 6f 67 72 61 6d 20 | 69 73 20 64 69 73 74 72 |program |is distr|
|00000230| 69 62 75 74 65 64 20 69 | 6e 20 74 68 65 20 68 6f |ibuted i|n the ho|
|00000240| 70 65 20 74 68 61 74 20 | 69 74 20 77 69 6c 6c 20 |pe that |it will |
|00000250| 62 65 20 75 73 65 66 75 | 6c 2c 0a 40 63 20 20 62 |be usefu|l,.@c b|
|00000260| 75 74 20 57 49 54 48 4f | 55 54 20 41 4e 59 20 57 |ut WITHO|UT ANY W|
|00000270| 41 52 52 41 4e 54 59 3b | 20 77 69 74 68 6f 75 74 |ARRANTY;| without|
|00000280| 20 65 76 65 6e 20 74 68 | 65 20 69 6d 70 6c 69 65 | even th|e implie|
|00000290| 64 20 77 61 72 72 61 6e | 74 79 20 6f 66 0a 40 63 |d warran|ty of.@c|
|000002a0| 20 20 4d 45 52 43 48 41 | 4e 54 41 42 49 4c 49 54 | MERCHA|NTABILIT|
|000002b0| 59 20 6f 72 20 46 49 54 | 4e 45 53 53 20 46 4f 52 |Y or FIT|NESS FOR|
|000002c0| 20 41 20 50 41 52 54 49 | 43 55 4c 41 52 20 50 55 | A PARTI|CULAR PU|
|000002d0| 52 50 4f 53 45 2e 20 20 | 53 65 65 20 74 68 65 0a |RPOSE. |See the.|
|000002e0| 40 63 20 20 47 4e 55 20 | 47 65 6e 65 72 61 6c 20 |@c GNU |General |
|000002f0| 50 75 62 6c 69 63 20 4c | 69 63 65 6e 73 65 20 66 |Public L|icense f|
|00000300| 6f 72 20 6d 6f 72 65 20 | 64 65 74 61 69 6c 73 2e |or more |details.|
|00000310| 0a 40 63 0a 40 63 20 20 | 59 6f 75 20 73 68 6f 75 |.@c.@c |You shou|
|00000320| 6c 64 20 68 61 76 65 20 | 72 65 63 65 69 76 65 64 |ld have |received|
|00000330| 20 61 20 63 6f 70 79 20 | 6f 66 20 74 68 65 20 47 | a copy |of the G|
|00000340| 4e 55 20 47 65 6e 65 72 | 61 6c 20 50 75 62 6c 69 |NU Gener|al Publi|
|00000350| 63 20 4c 69 63 65 6e 73 | 65 0a 40 63 20 20 61 6c |c Licens|e.@c al|
|00000360| 6f 6e 67 20 77 69 74 68 | 20 74 68 69 73 20 70 72 |ong with| this pr|
|00000370| 6f 67 72 61 6d 3b 20 69 | 66 20 6e 6f 74 2c 20 77 |ogram; i|f not, w|
|00000380| 72 69 74 65 20 74 6f 20 | 74 68 65 20 46 72 65 65 |rite to |the Free|
|00000390| 20 53 6f 66 74 77 61 72 | 65 0a 40 63 20 20 46 6f | Softwar|e.@c Fo|
|000003a0| 75 6e 64 61 74 69 6f 6e | 2c 20 49 6e 63 2e 2c 20 |undation|, Inc., |
|000003b0| 36 37 35 20 4d 61 73 73 | 20 41 76 65 2c 20 43 61 |675 Mass| Ave, Ca|
|000003c0| 6d 62 72 69 64 67 65 2c | 20 4d 41 20 30 32 31 33 |mbridge,| MA 0213|
|000003d0| 39 2c 20 55 53 41 2e 0a | 40 63 0a 40 63 0a 40 63 |9, USA..|@c.@c.@c|
|000003e0| 20 20 54 68 69 73 20 66 | 69 6c 65 20 63 6f 6e 74 | This f|ile cont|
|000003f0| 61 69 6e 73 20 74 68 65 | 20 65 6e 67 6c 69 73 68 |ains the| english|
|00000400| 20 64 6f 63 75 6d 65 6e | 74 61 74 69 6f 6e 2e 0a | documen|tation..|
|00000410| 40 63 0a 40 63 20 20 43 | 6f 6d 70 75 74 65 72 3a |@c.@c C|omputer:|
|00000420| 09 41 6d 69 67 61 20 31 | 32 30 30 09 09 20 20 20 |.Amiga 1|200.. |
|00000430| 20 43 6f 6d 70 69 6c 65 | 72 3a 09 44 49 43 45 20 | Compile|r:.DICE |
|00000440| 56 32 2e 30 37 2e 35 34 | 20 28 33 2e 30 29 0a 40 |V2.07.54| (3.0).@|
|00000450| 63 0a 40 63 20 20 41 75 | 74 6f 72 3a 09 4a 6f 63 |c.@c Au|tor:.Joc|
|00000460| 68 65 6e 20 57 69 65 64 | 6d 61 6e 6e 0a 40 63 09 |hen Wied|mann.@c.|
|00000470| 09 41 6d 20 45 69 73 74 | 65 69 63 68 20 39 0a 40 |.Am Eist|eich 9.@|
|00000480| 63 09 20 20 37 32 35 35 | 35 20 4d 65 74 7a 69 6e |c. 7255|5 Metzin|
|00000490| 67 65 6e 0a 40 63 09 09 | 54 65 6c 2e 20 30 37 31 |gen.@c..|Tel. 071|
|000004a0| 32 33 20 2f 20 31 34 38 | 38 31 0a 40 63 09 09 49 |23 / 148|81.@c..I|
|000004b0| 6e 74 65 72 6e 65 74 3a | 20 77 69 65 64 6d 61 6e |nternet:| wiedman|
|000004c0| 6e 40 6d 61 69 6c 73 65 | 72 76 2e 7a 64 76 2e 75 |n@mailse|rv.zdv.u|
|000004d0| 6e 69 2d 74 75 65 62 69 | 6e 67 65 6e 2e 64 65 0a |ni-tuebi|ngen.de.|
|000004e0| 40 63 0a 0a 40 73 65 74 | 20 56 45 52 53 49 4f 4e |@c..@set| VERSION|
|000004f0| 20 31 2e 30 0a 40 69 66 | 74 65 78 0a 40 70 61 72 | 1.0.@if|tex.@par|
|00000500| 73 6b 69 70 3d 30 2e 37 | 35 65 6d 0a 40 65 6e 64 |skip=0.7|5em.@end|
|00000510| 20 69 66 74 65 78 0a 40 | 63 20 25 2a 2a 65 6e 64 | iftex.@|c %**end|
|00000520| 20 6f 66 20 68 65 61 64 | 65 72 0a 0a 0a 40 74 69 | of head|er...@ti|
|00000530| 74 6c 65 70 61 67 65 0a | 0a 40 74 69 74 6c 65 7b |tlepage.|.@title{|
|00000540| 46 6c 65 78 43 61 74 7d | 0a 40 73 75 62 74 69 74 |FlexCat}|.@subtit|
|00000550| 6c 65 7b 54 68 65 20 66 | 6c 65 78 69 62 6c 65 20 |le{The f|lexible |
|00000560| 63 61 74 61 6c 6f 67 20 | 67 65 6e 65 72 61 74 6f |catalog |generato|
|00000570| 72 7d 0a 40 73 75 62 74 | 69 74 6c 65 7b 7d 0a 40 |r}.@subt|itle{}.@|
|00000580| 73 75 62 74 69 74 6c 65 | 7b 56 65 72 73 69 6f 6e |subtitle|{Version|
|00000590| 20 40 76 61 6c 75 65 7b | 56 45 52 53 49 4f 4e 7d | @value{|VERSION}|
|000005a0| 7d 0a 40 61 75 74 68 6f | 72 20 4a 6f 63 68 65 6e |}.@autho|r Jochen|
|000005b0| 20 57 69 65 64 6d 61 6e | 6e 0a 40 76 73 6b 69 70 | Wiedman|n.@vskip|
|000005c0| 20 30 70 74 20 70 6c 75 | 73 20 31 66 69 6c 6c 6c | 0pt plu|s 1filll|
|000005d0| 0a 40 74 65 78 0a 40 68 | 61 6c 69 67 6e 7b 40 68 |.@tex.@h|align{@h|
|000005e0| 66 69 6c 23 26 23 40 68 | 66 69 6c 40 63 72 0a 43 |fil#&#@h|fil@cr.C|
|000005f0| 6f 70 79 72 69 67 68 74 | 20 40 63 6f 70 79 72 69 |opyright| @copyri|
|00000600| 67 68 74 20 31 39 39 33 | 20 26 20 4a 6f 63 68 65 |ght 1993| & Joche|
|00000610| 6e 20 57 69 65 64 6d 61 | 6e 6e 40 63 72 0a 09 20 |n Wiedma|nn@cr.. |
|00000620| 20 20 26 20 41 6d 20 45 | 69 73 74 65 69 63 68 20 | & Am E|isteich |
|00000630| 39 40 63 72 0a 09 20 20 | 37 32 35 35 35 20 26 20 |9@cr.. |72555 & |
|00000640| 4d 65 74 7a 69 6e 67 65 | 6e 20 28 44 65 75 74 73 |Metzinge|n (Deuts|
|00000650| 63 68 6c 61 6e 64 29 40 | 63 72 0a 09 20 20 20 26 |chland)@|cr.. &|
|00000660| 20 54 65 6c 2e 20 30 37 | 31 32 33 20 2f 20 31 34 | Tel. 07|123 / 14|
|00000670| 38 38 31 40 63 72 0a 09 | 20 20 20 26 20 49 6e 74 |881@cr..| & Int|
|00000680| 65 72 6e 65 74 3a 20 77 | 69 65 64 6d 61 6e 6e 40 |ernet: w|iedmann@|
|00000690| 40 6d 61 69 6c 73 65 72 | 76 2e 7a 64 76 2e 75 6e |@mailser|v.zdv.un|
|000006a0| 69 2d 74 75 65 62 69 6e | 67 65 6e 2e 64 65 40 63 |i-tuebin|gen.de@c|
|000006b0| 72 0a 7d 0a 40 65 6e 64 | 20 74 65 78 0a 0a 50 65 |r.}.@end| tex..Pe|
|000006c0| 72 6d 69 73 73 69 6f 6e | 20 69 73 20 67 72 61 6e |rmission| is gran|
|000006d0| 74 65 64 20 74 6f 20 6d | 61 6b 65 20 61 6e 64 20 |ted to m|ake and |
|000006e0| 64 69 73 74 72 69 62 75 | 74 65 20 76 65 72 62 61 |distribu|te verba|
|000006f0| 74 69 6d 20 61 6e 64 20 | 6d 6f 64 69 66 69 65 64 |tim and |modified|
|00000700| 20 63 6f 70 69 65 73 20 | 6f 66 0a 74 68 69 73 20 | copies |of.this |
|00000710| 6d 61 6e 75 61 6c 20 61 | 6e 64 20 74 68 65 20 70 |manual a|nd the p|
|00000720| 72 6f 67 72 61 6d 20 46 | 6c 65 78 43 61 74 20 66 |rogram F|lexCat f|
|00000730| 6f 6c 6c 6f 77 69 6e 67 | 20 74 68 65 20 74 65 72 |ollowing| the ter|
|00000740| 6d 73 20 6f 66 20 74 68 | 65 20 60 60 47 4e 55 20 |ms of th|e ``GNU |
|00000750| 47 65 6e 65 72 61 6c 0a | 50 75 62 6c 69 63 20 4c |General.|Public L|
|00000760| 69 63 65 6e 73 65 27 27 | 20 70 72 6f 76 69 64 65 |icense''| provide|
|00000770| 64 20 74 68 65 20 63 6f | 70 79 72 69 67 68 74 20 |d the co|pyright |
|00000780| 6e 6f 74 69 63 65 20 61 | 6e 64 20 74 68 69 73 20 |notice a|nd this |
|00000790| 70 65 72 6d 69 73 73 69 | 6f 6e 20 6e 6f 74 69 63 |permissi|on notic|
|000007a0| 65 0a 61 72 65 20 70 72 | 65 73 65 72 76 65 64 20 |e.are pr|eserved |
|000007b0| 6f 6e 20 61 6c 6c 20 63 | 6f 70 69 65 73 20 61 6e |on all c|opies an|
|000007c0| 64 20 74 68 65 20 60 60 | 47 4e 55 20 47 65 6e 65 |d the ``|GNU Gene|
|000007d0| 72 61 6c 20 50 75 62 6c | 69 63 20 4c 69 63 65 6e |ral Publ|ic Licen|
|000007e0| 73 65 27 27 20 28 69 6e | 20 74 68 65 0a 66 69 6c |se'' (in| the.fil|
|000007f0| 65 20 40 66 69 6c 65 7b | 43 4f 50 59 49 4e 47 7d |e @file{|COPYING}|
|00000800| 29 20 69 73 20 64 69 73 | 74 72 69 62 75 74 65 64 |) is dis|tributed|
|00000810| 20 61 73 20 77 65 6c 6c | 2e 0a 0a 40 69 67 6e 6f | as well|...@igno|
|00000820| 72 65 0a 50 65 72 6d 69 | 73 73 69 6f 6e 20 69 73 |re.Permi|ssion is|
|00000830| 20 67 72 61 6e 74 65 64 | 20 74 6f 20 70 72 6f 63 | granted| to proc|
|00000840| 65 73 73 20 74 68 69 73 | 20 66 69 6c 65 20 62 79 |ess this| file by|
|00000850| 20 54 65 58 20 61 6e 64 | 20 70 72 69 6e 74 20 74 | TeX and| print t|
|00000860| 68 65 20 72 65 73 75 6c | 74 73 2c 0a 70 72 6f 76 |he resul|ts,.prov|
|00000870| 69 64 65 64 20 74 68 65 | 20 70 72 69 6e 74 65 64 |ided the| printed|
|00000880| 20 64 6f 63 75 6d 65 6e | 74 20 63 61 72 72 69 65 | documen|t carrie|
|00000890| 73 20 61 20 63 6f 70 79 | 69 6e 67 20 70 65 72 6d |s a copy|ing perm|
|000008a0| 69 73 73 69 6f 6e 20 6e | 6f 74 69 63 65 20 69 64 |ission n|otice id|
|000008b0| 65 6e 74 69 63 61 6c 20 | 74 6f 0a 74 68 69 73 20 |entical |to.this |
|000008c0| 6f 6e 65 20 65 78 63 65 | 70 74 20 66 6f 72 20 74 |one exce|pt for t|
|000008d0| 68 65 20 72 65 6d 6f 76 | 61 6c 20 6f 66 20 74 68 |he remov|al of th|
|000008e0| 69 73 20 70 61 72 61 67 | 72 61 70 68 20 28 74 68 |is parag|raph (th|
|000008f0| 69 73 20 70 61 72 61 67 | 72 61 70 68 20 6e 6f 74 |is parag|raph not|
|00000900| 20 62 65 69 6e 67 0a 72 | 65 6c 65 76 61 6e 74 20 | being.r|elevant |
|00000910| 74 6f 20 74 68 65 20 70 | 72 69 6e 74 65 64 20 6d |to the p|rinted m|
|00000920| 61 6e 75 61 6c 29 2e 0a | 40 65 6e 64 20 69 67 6e |anual)..|@end ign|
|00000930| 6f 72 65 0a 0a 54 68 65 | 20 61 75 74 68 6f 72 20 |ore..The| author |
|00000940| 67 69 76 65 73 20 40 73 | 74 72 6f 6e 67 7b 61 62 |gives @s|trong{ab|
|00000950| 73 6f 6c 75 74 65 6c 79 | 20 6e 6f 7d 20 77 61 72 |solutely| no} war|
|00000960| 72 61 6e 74 79 20 74 68 | 61 74 20 74 68 65 20 70 |ranty th|at the p|
|00000970| 72 6f 67 72 61 6d 20 64 | 65 73 63 72 69 62 65 64 |rogram d|escribed|
|00000980| 0a 69 6e 20 74 68 69 73 | 20 64 6f 63 75 6d 65 6e |.in this| documen|
|00000990| 74 61 74 69 6f 6e 20 61 | 6e 64 20 74 68 65 20 72 |tation a|nd the r|
|000009a0| 65 73 75 6c 74 73 20 70 | 72 6f 64 75 63 65 64 20 |esults p|roduced |
|000009b0| 62 79 20 69 74 20 61 72 | 65 20 63 6f 72 72 65 63 |by it ar|e correc|
|000009c0| 74 2e 20 54 68 65 0a 61 | 75 74 68 6f 72 20 63 61 |t. The.a|uthor ca|
|000009d0| 6e 6e 6f 74 20 62 65 20 | 68 65 6c 64 20 72 65 73 |nnot be |held res|
|000009e0| 70 6f 6e 73 69 62 6c 65 | 20 66 6f 72 20 40 73 74 |ponsible| for @st|
|000009f0| 72 6f 6e 67 7b 61 6e 79 | 7d 20 64 61 6d 61 67 65 |rong{any|} damage|
|00000a00| 20 20 72 65 73 75 6c 74 | 69 6e 67 20 66 72 6f 6d | result|ing from|
|00000a10| 0a 74 68 65 20 75 73 65 | 20 6f 66 20 74 68 69 73 |.the use| of this|
|00000a20| 20 73 6f 66 74 77 61 72 | 65 2e 0a 40 65 6e 64 20 | softwar|e..@end |
|00000a30| 74 69 74 6c 65 70 61 67 | 65 0a 40 69 66 74 65 78 |titlepag|e.@iftex|
|00000a40| 0a 40 68 65 61 64 69 6e | 67 73 20 64 6f 75 62 6c |.@headin|gs doubl|
|00000a50| 65 0a 40 65 6e 64 20 69 | 66 74 65 78 0a 0a 40 69 |e.@end i|ftex..@i|
|00000a60| 66 69 6e 66 6f 0a 40 6e | 6f 64 65 20 54 6f 70 0a |finfo.@n|ode Top.|
|00000a70| 40 74 6f 70 20 46 6c 65 | 78 43 61 74 20 56 40 76 |@top Fle|xCat V@v|
|00000a80| 61 6c 75 65 7b 56 45 52 | 53 49 4f 4e 7d 20 44 6f |alue{VER|SION} Do|
|00000a90| 63 75 6d 65 6e 74 61 74 | 69 6f 6e 0a 54 68 69 73 |cumentat|ion.This|
|00000aa0| 20 66 69 6c 65 20 64 65 | 73 63 72 69 62 65 73 20 | file de|scribes |
|00000ab0| 74 68 65 20 55 73 61 67 | 65 20 6f 66 20 46 6c 65 |the Usag|e of Fle|
|00000ac0| 78 43 61 74 20 56 40 76 | 61 6c 75 65 7b 56 45 52 |xCat V@v|alue{VER|
|00000ad0| 53 49 4f 4e 7d 2c 20 61 | 20 70 72 6f 67 72 61 6d |SION}, a| program|
|00000ae0| 20 77 68 69 63 68 0a 67 | 65 6e 65 72 61 74 65 73 | which.g|enerates|
|00000af0| 20 63 61 74 61 6c 6f 67 | 73 20 61 6e 64 20 74 68 | catalog|s and th|
|00000b00| 65 20 73 6f 75 72 63 65 | 20 74 6f 20 68 61 6e 64 |e source| to hand|
|00000b10| 6c 65 20 74 68 65 6d 2e | 20 46 6c 65 78 43 61 74 |le them.| FlexCat|
|00000b20| 20 77 6f 72 6b 73 20 73 | 69 6d 69 6c 61 72 20 74 | works s|imilar t|
|00000b30| 6f 0a 40 63 6f 64 65 7b | 43 61 74 43 6f 6d 70 7d |o.@code{|CatComp}|
|00000b40| 20 61 6e 64 20 40 63 6f | 64 65 7b 4b 69 74 43 61 | and @co|de{KitCa|
|00000b50| 74 7d 2c 20 62 75 74 20 | 64 69 66 66 65 72 73 20 |t}, but |differs |
|00000b60| 69 6e 20 67 65 6e 65 72 | 61 74 69 6e 67 20 61 6e |in gener|ating an|
|00000b70| 79 20 73 6f 75 72 63 65 | 20 79 6f 75 0a 77 61 6e |y source| you.wan|
|00000b80| 74 2e 20 54 68 69 73 20 | 69 73 20 64 6f 6e 65 20 |t. This |is done |
|00000b90| 62 79 20 75 73 69 6e 67 | 20 74 68 65 20 73 6f 20 |by using| the so |
|00000ba0| 63 61 6c 6c 65 64 20 40 | 63 6f 64 65 7b 53 6f 75 |called @|code{Sou|
|00000bb0| 72 63 65 20 64 65 73 63 | 72 69 70 74 69 6f 6e 73 |rce desc|riptions|
|00000bc0| 7d 2c 20 77 68 69 63 68 | 0a 61 72 65 20 61 20 74 |}, which|.are a t|
|00000bd0| 65 6d 70 6c 61 74 65 20 | 66 6f 72 20 74 68 65 20 |emplate |for the |
|00000be0| 63 6f 64 65 20 74 6f 20 | 67 65 6e 65 72 61 74 65 |code to |generate|
|00000bf0| 2e 20 54 68 65 79 20 63 | 61 6e 20 62 65 20 65 64 |. They c|an be ed|
|00000c00| 69 74 65 64 20 61 6e 64 | 20 68 65 6e 63 65 0a 61 |ited and| hence.a|
|00000c10| 64 61 70 74 65 64 20 74 | 6f 20 61 6e 79 20 70 72 |dapted t|o any pr|
|00000c20| 6f 67 72 61 6d 6d 69 6e | 67 20 6c 61 6e 67 75 61 |ogrammin|g langua|
|00000c30| 67 65 20 61 6e 64 20 69 | 6e 64 69 76 69 64 75 61 |ge and i|ndividua|
|00000c40| 6c 20 6e 65 65 64 73 2e | 20 28 48 6f 70 65 66 75 |l needs.| (Hopefu|
|00000c50| 6c 6c 79 21 29 0a 0a 40 | 6d 65 6e 75 0a 47 65 6e |lly!)..@|menu.Gen|
|00000c60| 65 72 61 6c 3a 0a 0a 2a | 20 44 69 73 63 6c 61 69 |eral:..*| Disclai|
|00000c70| 6d 65 72 3a 3a 09 20 20 | 20 20 20 43 6f 70 79 72 |mer::. | Copyr|
|00000c80| 69 67 68 74 73 2c 20 28 | 4e 4f 29 20 77 61 72 72 |ights, (|NO) warr|
|00000c90| 61 6e 74 79 0a 2a 20 53 | 75 72 76 65 79 3a 3a 09 |anty.* S|urvey::.|
|00000ca0| 20 20 20 20 20 57 68 61 | 74 20 69 73 20 46 6c 65 | Wha|t is Fle|
|00000cb0| 78 43 61 74 3f 0a 2a 20 | 49 6e 73 74 61 6c 6c 61 |xCat?.* |Installa|
|00000cc0| 74 69 6f 6e 3a 3a 20 20 | 20 20 20 48 6f 77 20 63 |tion:: | How c|
|00000cd0| 61 6e 20 49 20 67 65 74 | 20 69 74 20 77 6f 72 6b |an I get| it work|
|00000ce0| 69 6e 67 3f 0a 0a 55 73 | 69 6e 67 20 46 6c 65 78 |ing?..Us|ing Flex|
|00000cf0| 43 61 74 3a 0a 0a 2a 20 | 50 72 6f 67 72 61 6d 20 |Cat:..* |Program |
|00000d00| 73 74 61 72 74 3a 3a 09 | 20 43 61 6c 6c 69 6e 67 |start::.| Calling|
|00000d10| 20 46 6c 65 78 43 61 74 | 20 66 72 6f 6d 20 74 68 | FlexCat| from th|
|00000d20| 65 20 43 4c 49 0a 2a 20 | 43 61 74 61 6c 6f 67 20 |e CLI.* |Catalog |
|00000d30| 64 65 73 63 72 69 70 74 | 69 6f 6e 3a 3a 20 20 43 |descript|ion:: C|
|00000d40| 61 74 61 6c 6f 67 20 64 | 65 73 63 72 69 70 74 69 |atalog d|escripti|
|00000d50| 6f 6e 20 66 69 6c 65 73 | 20 28 40 6b 65 79 7b 2e |on files| (@key{.|
|00000d60| 63 64 7d 2d 66 69 6c 65 | 73 29 0a 2a 20 43 61 74 |cd}-file|s).* Cat|
|00000d70| 61 6c 6f 67 20 74 72 61 | 6e 73 6c 61 74 69 6f 6e |alog tra|nslation|
|00000d80| 3a 3a 20 20 43 61 74 61 | 6c 6f 67 20 74 72 61 6e |:: Cata|log tran|
|00000d90| 73 6c 61 74 69 6f 6e 20 | 66 69 6c 65 73 20 28 40 |slation |files (@|
|00000da0| 6b 65 79 7b 2e 63 74 7d | 2d 66 69 6c 65 73 29 0a |key{.ct}|-files).|
|00000db0| 2a 20 53 6f 75 72 63 65 | 20 64 65 73 63 72 69 70 |* Source| descrip|
|00000dc0| 74 69 6f 6e 3a 3a 09 20 | 53 6f 75 72 63 65 20 64 |tion::. |Source d|
|00000dd0| 65 73 63 72 69 70 74 69 | 6f 6e 20 28 40 6b 65 79 |escripti|on (@key|
|00000de0| 7b 2e 73 64 7d 2d 66 69 | 6c 65 73 29 0a 2a 20 55 |{.sd}-fi|les).* U|
|00000df0| 73 69 6e 67 20 46 6c 65 | 78 43 61 74 20 73 6f 75 |sing Fle|xCat sou|
|00000e00| 72 63 65 3a 3a 20 55 73 | 69 6e 67 20 46 6c 65 78 |rce:: Us|ing Flex|
|00000e10| 43 61 74 20 73 6f 75 72 | 63 65 20 69 6e 20 6f 77 |Cat sour|ce in ow|
|00000e20| 6e 20 70 72 6f 67 72 61 | 6d 73 0a 0a 55 6e 6e 65 |n progra|ms..Unne|
|00000e30| 63 65 73 73 69 74 69 65 | 73 3a 0a 0a 2a 20 46 75 |cessitie|s:..* Fu|
|00000e40| 74 75 72 65 3a 3a 09 09 | 46 75 72 74 68 65 72 20 |ture::..|Further |
|00000e50| 64 65 76 65 6c 6f 70 6d | 65 6e 74 20 6f 66 20 46 |developm|ent of F|
|00000e60| 6c 65 78 43 61 74 0a 2a | 20 43 72 65 64 69 74 73 |lexCat.*| Credits|
|00000e70| 3a 3a 09 09 57 68 61 74 | 20 49 20 61 6c 77 61 79 |::..What| I alway|
|00000e80| 73 20 77 61 6e 74 65 64 | 20 74 6f 20 73 61 79 40 |s wanted| to say@|
|00000e90| 64 6f 74 73 7b 7d 0a 2a | 20 49 6e 64 65 78 3a 3a |dots{}.*| Index::|
|00000ea0| 09 09 57 68 65 72 65 20 | 79 6f 75 20 66 69 6e 64 |..Where |you find|
|00000eb0| 20 77 68 61 74 20 79 6f | 75 20 61 72 65 20 6e 65 | what yo|u are ne|
|00000ec0| 76 65 72 20 6c 6f 6f 6b | 69 6e 67 20 66 6f 72 0a |ver look|ing for.|
|00000ed0| 40 65 6e 64 20 6d 65 6e | 75 0a 40 65 6e 64 20 69 |@end men|u.@end i|
|00000ee0| 66 69 6e 66 6f 0a 0a 0a | 0a 0a 0a 40 69 66 69 6e |finfo...|...@ifin|
|00000ef0| 66 6f 0a 40 6e 6f 64 65 | 20 44 69 73 63 6c 61 69 |fo.@node| Disclai|
|00000f00| 6d 65 72 0a 40 63 68 61 | 70 74 65 72 20 43 6f 70 |mer.@cha|pter Cop|
|00000f10| 79 72 69 67 68 74 20 61 | 6e 64 20 6f 74 68 65 72 |yright a|nd other|
|00000f20| 20 6c 65 67 61 6c 20 73 | 74 75 66 66 0a 40 63 69 | legal s|tuff.@ci|
|00000f30| 6e 64 65 78 20 43 6f 70 | 79 72 69 67 68 74 0a 40 |ndex Cop|yright.@|
|00000f40| 63 69 6e 64 65 78 20 44 | 69 73 74 72 69 62 75 74 |cindex D|istribut|
|00000f50| 69 6f 6e 0a 40 63 69 6e | 64 65 78 20 50 65 72 6d |ion.@cin|dex Perm|
|00000f60| 69 73 73 69 6f 6e 73 0a | 40 63 69 6e 64 65 78 20 |issions.|@cindex |
|00000f70| 50 72 6f 68 69 62 69 74 | 69 6f 6e 73 0a 40 63 69 |Prohibit|ions.@ci|
|00000f80| 6e 64 65 78 20 41 75 74 | 68 6f 72 0a 40 63 69 6e |ndex Aut|hor.@cin|
|00000f90| 64 65 78 20 41 64 72 65 | 73 73 0a 40 63 69 6e 64 |dex Adre|ss.@cind|
|00000fa0| 65 78 20 49 6e 74 65 72 | 6e 65 74 0a 40 63 69 6e |ex Inter|net.@cin|
|00000fb0| 64 65 78 20 4d 61 69 6c | 0a 40 65 78 61 6d 70 6c |dex Mail|.@exampl|
|00000fc0| 65 0a 43 6f 70 79 72 69 | 67 68 74 20 40 63 6f 70 |e.Copyri|ght @cop|
|00000fd0| 79 72 69 67 68 74 7b 7d | 20 31 39 39 33 09 4a 6f |yright{}| 1993.Jo|
|00000fe0| 63 68 65 6e 20 57 69 65 | 64 6d 61 6e 6e 0a 09 09 |chen Wie|dmann...|
|00000ff0| 09 41 6d 20 45 69 73 74 | 65 69 63 68 20 39 0a 09 |.Am Eist|eich 9..|
|00001000| 09 20 20 37 32 35 35 35 | 20 4d 65 74 7a 69 6e 67 |. 72555| Metzing|
|00001010| 65 6e 20 28 44 65 75 74 | 73 63 68 6c 61 6e 64 29 |en (Deut|schland)|
|00001020| 0a 09 09 09 54 65 6c 2e | 20 30 37 31 32 33 20 2f |....Tel.| 07123 /|
|00001030| 20 31 34 38 38 31 0a 09 | 09 09 49 6e 74 65 72 6e | 14881..|..Intern|
|00001040| 65 74 3a 20 77 69 65 64 | 6d 61 6e 6e 40 40 6d 61 |et: wied|mann@@ma|
|00001050| 69 6c 73 65 72 76 2e 7a | 64 76 2e 75 6e 69 2d 74 |ilserv.z|dv.uni-t|
|00001060| 75 65 62 69 6e 67 65 6e | 2e 64 65 0a 40 65 6e 64 |uebingen|.de.@end|
|00001070| 20 65 78 61 6d 70 6c 65 | 0a 0a 50 65 72 6d 69 73 | example|..Permis|
|00001080| 73 69 6f 6e 20 69 73 20 | 67 72 61 6e 74 65 64 20 |sion is |granted |
|00001090| 74 6f 20 6d 61 6b 65 20 | 61 6e 64 20 64 69 73 74 |to make |and dist|
|000010a0| 72 69 62 75 74 65 20 76 | 65 72 62 61 74 69 6d 20 |ribute v|erbatim |
|000010b0| 61 6e 64 20 6d 6f 64 69 | 66 69 65 64 20 63 6f 70 |and modi|fied cop|
|000010c0| 69 65 73 20 6f 66 0a 74 | 68 69 73 20 64 6f 63 75 |ies of.t|his docu|
|000010d0| 6d 65 6e 74 61 74 69 6f | 6e 20 61 6e 64 20 74 68 |mentatio|n and th|
|000010e0| 65 20 70 72 6f 67 72 61 | 6d 20 46 6c 65 78 43 61 |e progra|m FlexCa|
|000010f0| 74 20 66 6f 6c 6c 6f 77 | 69 6e 67 20 74 68 65 20 |t follow|ing the |
|00001100| 74 65 72 6d 73 20 6f 66 | 20 74 68 65 20 60 60 47 |terms of| the ``G|
|00001110| 4e 55 0a 47 65 6e 65 72 | 61 6c 20 50 75 62 6c 69 |NU.Gener|al Publi|
|00001120| 63 20 4c 69 63 65 6e 73 | 65 27 27 20 70 72 6f 76 |c Licens|e'' prov|
|00001130| 69 64 65 64 20 74 68 65 | 20 63 6f 70 79 72 69 67 |ided the| copyrig|
|00001140| 68 74 20 6e 6f 74 69 63 | 65 20 61 6e 64 20 74 68 |ht notic|e and th|
|00001150| 69 73 20 70 65 72 6d 69 | 73 73 69 6f 6e 0a 6e 6f |is permi|ssion.no|
|00001160| 74 69 63 65 20 61 72 65 | 20 70 72 65 73 65 72 76 |tice are| preserv|
|00001170| 65 64 20 6f 6e 20 61 6c | 6c 20 63 6f 70 69 65 73 |ed on al|l copies|
|00001180| 20 61 6e 64 20 74 68 65 | 20 60 60 47 4e 55 20 47 | and the| ``GNU G|
|00001190| 65 6e 65 72 61 6c 20 50 | 75 62 6c 69 63 20 4c 69 |eneral P|ublic Li|
|000011a0| 63 65 6e 73 65 27 27 0a | 28 69 6e 20 74 68 65 20 |cense''.|(in the |
|000011b0| 66 69 6c 65 20 40 66 69 | 6c 65 7b 43 4f 50 59 49 |file @fi|le{COPYI|
|000011c0| 4e 47 7d 29 20 69 73 20 | 64 69 73 74 72 69 62 75 |NG}) is |distribu|
|000011d0| 74 65 64 20 61 73 20 77 | 65 6c 6c 2e 0a 0a 40 69 |ted as w|ell...@i|
|000011e0| 67 6e 6f 72 65 0a 50 65 | 72 6d 69 73 73 69 6f 6e |gnore.Pe|rmission|
|000011f0| 20 69 73 20 67 72 61 6e | 74 65 64 20 74 6f 20 70 | is gran|ted to p|
|00001200| 72 6f 63 65 73 73 20 74 | 68 69 73 20 66 69 6c 65 |rocess t|his file|
|00001210| 20 62 79 20 54 65 58 20 | 61 6e 64 20 70 72 69 6e | by TeX |and prin|
|00001220| 74 20 74 68 65 20 72 65 | 73 75 6c 74 73 2c 0a 70 |t the re|sults,.p|
|00001230| 72 6f 76 69 64 65 64 20 | 74 68 65 20 70 72 69 6e |rovided |the prin|
|00001240| 74 65 64 20 64 6f 63 75 | 6d 65 6e 74 20 63 61 72 |ted docu|ment car|
|00001250| 72 69 65 73 20 61 20 63 | 6f 70 79 69 6e 67 20 70 |ries a c|opying p|
|00001260| 65 72 6d 69 73 73 69 6f | 6e 20 6e 6f 74 69 63 65 |ermissio|n notice|
|00001270| 20 69 64 65 6e 74 69 63 | 61 6c 20 74 6f 0a 74 68 | identic|al to.th|
|00001280| 69 73 20 6f 6e 65 20 65 | 78 63 65 70 74 20 66 6f |is one e|xcept fo|
|00001290| 72 20 74 68 65 20 72 65 | 6d 6f 76 61 6c 20 6f 66 |r the re|moval of|
|000012a0| 20 74 68 69 73 20 70 61 | 72 61 67 72 61 70 68 20 | this pa|ragraph |
|000012b0| 28 74 68 69 73 20 70 61 | 72 61 67 72 61 70 68 20 |(this pa|ragraph |
|000012c0| 6e 6f 74 20 62 65 69 6e | 67 0a 72 65 6c 65 76 61 |not bein|g.releva|
|000012d0| 6e 74 20 74 6f 20 74 68 | 65 20 70 72 69 6e 74 65 |nt to th|e printe|
|000012e0| 64 20 6d 61 6e 75 61 6c | 29 2e 0a 40 65 6e 64 20 |d manual|)..@end |
|000012f0| 69 67 6e 6f 72 65 0a 0a | 54 68 65 20 61 75 74 68 |ignore..|The auth|
|00001300| 6f 72 20 67 69 76 65 73 | 20 40 73 74 72 6f 6e 67 |or gives| @strong|
|00001310| 7b 61 62 73 6f 6c 75 74 | 65 6c 79 20 6e 6f 7d 20 |{absolut|ely no} |
|00001320| 77 61 72 72 61 6e 74 79 | 20 74 68 61 74 20 74 68 |warranty| that th|
|00001330| 65 20 70 72 6f 67 72 61 | 6d 20 64 65 73 63 72 69 |e progra|m descri|
|00001340| 62 65 64 0a 69 6e 20 74 | 68 69 73 20 64 6f 63 75 |bed.in t|his docu|
|00001350| 6d 65 6e 74 61 74 69 6f | 6e 20 61 6e 64 20 74 68 |mentatio|n and th|
|00001360| 65 20 72 65 73 75 6c 74 | 73 20 70 72 6f 64 75 63 |e result|s produc|
|00001370| 65 64 20 62 79 20 69 74 | 20 61 72 65 20 63 6f 72 |ed by it| are cor|
|00001380| 72 65 63 74 2e 20 54 68 | 65 0a 61 75 74 68 6f 72 |rect. Th|e.author|
|00001390| 20 63 61 6e 6e 6f 74 20 | 62 65 20 68 65 6c 64 20 | cannot |be held |
|000013a0| 72 65 73 70 6f 6e 73 69 | 62 6c 65 20 66 6f 72 20 |responsi|ble for |
|000013b0| 40 73 74 72 6f 6e 67 7b | 61 6e 79 7d 20 64 61 6d |@strong{|any} dam|
|000013c0| 61 67 65 20 20 72 65 73 | 75 6c 74 69 6e 67 20 66 |age res|ulting f|
|000013d0| 72 6f 6d 0a 74 68 65 20 | 75 73 65 20 6f 66 20 74 |rom.the |use of t|
|000013e0| 68 69 73 20 73 6f 66 74 | 77 61 72 65 2e 0a 40 65 |his soft|ware..@e|
|000013f0| 6e 64 20 69 66 69 6e 66 | 6f 0a 0a 0a 0a 40 6e 6f |nd ifinf|o....@no|
|00001400| 64 65 20 53 75 72 76 65 | 79 0a 40 63 68 61 70 74 |de Surve|y.@chapt|
|00001410| 65 72 20 53 75 72 76 65 | 79 0a 40 63 69 6e 64 65 |er Surve|y.@cinde|
|00001420| 78 20 53 75 72 76 65 79 | 0a 53 69 6e 63 65 20 57 |x Survey|.Since W|
|00001430| 6f 72 6b 62 65 6e 63 68 | 20 32 2e 31 20 74 68 65 |orkbench| 2.1 the|
|00001440| 20 41 6d 69 67 61 20 6f | 66 66 65 72 73 20 61 20 | Amiga o|ffers a |
|00001450| 72 61 74 68 65 72 20 70 | 6c 65 61 73 61 6e 74 20 |rather p|leasant |
|00001460| 73 79 73 74 65 6d 20 6f | 66 20 75 73 69 6e 67 0a |system o|f using.|
|00001470| 70 72 6f 67 72 61 6d 73 | 20 69 6e 20 64 69 66 66 |programs| in diff|
|00001480| 65 72 65 6e 74 20 6c 61 | 6e 67 75 61 67 65 73 3a |erent la|nguages:|
|00001490| 20 54 68 65 20 40 63 6f | 64 65 7b 6c 6f 63 61 6c | The @co|de{local|
|000014a0| 65 2e 6c 69 62 72 61 72 | 79 7d 2e 20 28 54 68 69 |e.librar|y}. (Thi|
|000014b0| 73 20 69 73 0a 63 61 6c | 6c 65 64 20 6c 6f 63 61 |s is.cal|led loca|
|000014c0| 6c 69 7a 69 6e 67 2c 20 | 74 68 61 74 27 73 20 77 |lizing, |that's w|
|000014d0| 68 61 74 20 74 68 65 20 | 6e 61 6d 65 27 73 20 66 |hat the |name's f|
|000014e0| 6f 72 2e 29 0a 0a 54 68 | 65 20 69 64 65 61 20 69 |or.)..Th|e idea i|
|000014f0| 73 20 73 69 6d 70 6c 65 | 3a 20 59 6f 75 20 73 65 |s simple|: You se|
|00001500| 6c 65 63 74 20 61 20 6c | 61 6e 67 75 61 67 65 2c |lect a l|anguage,|
|00001510| 20 74 68 65 20 65 6e 67 | 6c 69 73 68 20 69 6e 20 | the eng|lish in |
|00001520| 6d 6f 73 74 20 63 61 73 | 65 73 20 61 6e 64 0a 77 |most cas|es and.w|
|00001530| 72 69 74 65 20 79 6f 75 | 72 20 70 72 6f 67 72 61 |rite you|r progra|
|00001540| 6d 20 69 6e 20 74 68 65 | 20 73 61 6d 65 20 6d 61 |m in the| same ma|
|00001550| 6e 6e 65 72 20 61 73 20 | 79 6f 75 20 64 69 64 20 |nner as |you did |
|00001560| 77 69 74 68 6f 75 74 20 | 6c 6f 63 61 6c 69 7a 69 |without |localizi|
|00001570| 6e 67 2c 20 65 78 63 65 | 70 74 0a 74 68 61 74 20 |ng, exce|pt.that |
|00001580| 63 6f 6e 73 74 61 6e 74 | 20 73 74 72 69 6e 67 73 |constant| strings|
|00001590| 20 61 72 65 20 72 65 70 | 6c 61 63 65 64 20 62 79 | are rep|laced by|
|000015a0| 20 63 65 72 74 61 69 6e | 20 66 75 6e 63 74 69 6f | certain| functio|
|000015b0| 6e 20 63 61 6c 6c 73 2e | 20 41 6e 6f 74 68 65 72 |n calls.| Another|
|000015c0| 0a 66 75 6e 63 74 69 6f | 6e 20 63 61 6c 6c 20 6d |.functio|n call m|
|000015d0| 61 6b 65 73 20 69 74 20 | 70 6f 73 73 69 62 6c 65 |akes it |possible|
|000015e0| 20 74 68 61 74 20 74 68 | 65 20 75 73 65 72 20 73 | that th|e user s|
|000015f0| 65 6c 65 63 74 73 20 61 | 6e 6f 74 68 65 72 20 6c |elects a|nother l|
|00001600| 61 6e 67 75 61 67 65 0a | 77 68 65 6e 20 74 68 65 |anguage.|when the|
|00001610| 20 70 72 6f 67 72 61 6d | 20 73 74 61 72 74 73 2e | program| starts.|
|00001620| 20 28 54 68 65 20 6c 61 | 74 74 65 72 20 66 75 6e | (The la|tter fun|
|00001630| 63 74 69 6f 6e 20 63 61 | 6c 6c 20 6c 6f 61 64 73 |ction ca|ll loads|
|00001640| 20 61 6e 20 65 78 74 65 | 72 6e 61 6c 20 66 69 6c | an exte|rnal fil|
|00001650| 65 2c 0a 74 68 65 20 73 | 6f 20 63 61 6c 6c 65 64 |e,.the s|o called|
|00001660| 20 40 63 6f 64 65 7b 63 | 61 74 61 6c 6f 67 7d 20 | @code{c|atalog} |
|00001670| 61 6e 64 20 6d 61 6b 65 | 73 20 74 68 65 20 66 6f |and make|s the fo|
|00001680| 72 6d 65 72 20 74 6f 20 | 72 65 61 64 20 74 68 65 |rmer to |read the|
|00001690| 20 73 74 72 69 6e 67 73 | 20 66 72 6f 6d 0a 74 68 | strings| from.th|
|000016a0| 65 20 63 61 74 61 6c 6f | 67 20 69 6e 73 74 65 61 |e catalo|g instea|
|000016b0| 64 20 6f 66 20 75 73 69 | 6e 67 20 74 68 65 20 70 |d of usi|ng the p|
|000016c0| 72 65 64 65 66 69 6e 65 | 64 20 73 74 72 69 6e 67 |redefine|d string|
|000016d0| 73 2e 29 0a 0a 54 68 65 | 73 65 20 63 61 74 61 6c |s.)..The|se catal|
|000016e0| 6f 67 73 20 61 72 65 20 | 69 6e 64 65 70 65 6e 64 |ogs are |independ|
|000016f0| 65 6e 74 20 66 72 6f 6d | 20 74 68 65 20 70 72 6f |ent from| the pro|
|00001700| 67 72 61 6d 2e 20 41 6c | 6c 20 79 6f 75 20 6e 65 |gram. Al|l you ne|
|00001710| 65 64 20 74 6f 20 64 6f | 20 66 6f 72 0a 61 64 64 |ed to do| for.add|
|00001720| 69 6e 67 20 61 6e 6f 74 | 68 65 72 20 6c 61 6e 67 |ing anot|her lang|
|00001730| 75 61 67 65 20 69 73 20 | 74 6f 20 63 72 65 61 74 |uage is |to creat|
|00001740| 65 20 61 20 6e 65 77 20 | 63 61 74 61 6c 6f 67 20 |e a new |catalog |
|00001750| 66 69 6c 65 20 61 6e 64 | 20 74 68 69 73 20 69 73 |file and| this is|
|00001760| 0a 70 6f 73 73 69 62 6c | 65 20 61 74 20 61 6e 79 |.possibl|e at any|
|00001770| 20 74 69 6d 65 20 77 69 | 74 68 6f 75 74 20 63 68 | time wi|thout ch|
|00001780| 61 6e 67 69 6e 67 20 74 | 68 65 20 70 72 6f 67 72 |anging t|he progr|
|00001790| 61 6d 2e 0a 0a 42 75 74 | 20 74 68 65 72 65 20 61 |am...But| there a|
|000017a0| 72 65 20 61 64 64 69 74 | 69 6f 6e 61 6c 20 74 61 |re addit|ional ta|
|000017b0| 73 6b 73 20 66 6f 72 20 | 74 68 65 20 70 72 6f 67 |sks for |the prog|
|000017c0| 72 61 6d 6d 65 72 3a 20 | 48 65 20 6e 65 65 64 73 |rammer: |He needs|
|000017d0| 20 74 6f 20 63 72 65 61 | 74 65 20 74 68 65 0a 63 | to crea|te the.c|
|000017e0| 61 74 61 6c 6f 67 73 2c | 20 74 68 65 20 70 72 65 |atalogs,| the pre|
|000017f0| 64 65 66 69 6e 65 64 20 | 73 74 72 69 6e 67 73 20 |defined |strings |
|00001800| 61 6e 64 20 73 6f 6d 65 | 20 73 6f 75 72 63 65 20 |and some| source |
|00001810| 74 6f 20 68 61 6e 64 6c | 65 20 74 68 65 6d 20 61 |to handl|e them a|
|00001820| 6c 6c 2e 20 28 54 68 65 | 0a 66 75 6e 63 74 69 6f |ll. (The|.functio|
|00001830| 6e 73 20 74 68 61 74 20 | 61 72 65 20 6d 65 6e 74 |ns that |are ment|
|00001840| 69 6f 6e 65 64 20 61 62 | 6f 76 65 2e 29 20 46 6c |ioned ab|ove.) Fl|
|00001850| 65 78 43 61 74 20 69 73 | 20 64 65 73 69 67 6e 65 |exCat is| designe|
|00001860| 64 20 74 6f 20 6d 61 6b | 65 20 74 68 69 73 20 69 |d to mak|e this i|
|00001870| 6e 0a 61 6e 20 65 61 73 | 79 20 61 6e 64 20 6e 65 |n.an eas|y and ne|
|00001880| 61 72 6c 79 20 61 75 74 | 6f 6d 61 74 69 63 20 6d |arly aut|omatic m|
|00001890| 61 6e 6e 65 72 20 77 69 | 74 68 6f 75 74 20 6c 6f |anner wi|thout lo|
|000018a0| 73 69 6e 67 20 66 6c 65 | 78 69 62 69 6c 69 74 79 |sing fle|xibility|
|000018b0| 20 65 73 70 65 63 69 61 | 6c 6c 79 0a 69 6e 20 63 | especia|lly.in c|
|000018c0| 72 65 61 74 69 6e 67 20 | 74 68 65 20 73 6f 75 72 |reating |the sour|
|000018d0| 63 65 2e 20 55 73 69 6e | 67 20 63 61 74 61 6c 6f |ce. Usin|g catalo|
|000018e0| 67 73 20 77 69 74 68 20 | 46 6c 65 78 43 61 74 20 |gs with |FlexCat |
|000018f0| 77 6f 72 6b 73 20 6c 69 | 6b 65 20 74 68 69 73 3a |works li|ke this:|
|00001900| 0a 0a 40 65 6e 75 6d 65 | 72 61 74 65 0a 40 69 74 |..@enume|rate.@it|
|00001910| 65 6d 20 59 6f 75 20 73 | 74 61 72 74 20 62 79 20 |em You s|tart by |
|00001920| 63 72 65 61 74 69 6e 67 | 20 61 20 66 69 6c 65 20 |creating| a file |
|00001930| 63 6f 6e 74 61 69 6e 69 | 6e 67 20 74 68 65 20 70 |containi|ng the p|
|00001940| 72 65 64 65 66 69 6e 65 | 64 20 73 74 72 69 6e 67 |redefine|d string|
|00001950| 73 20 61 6e 64 0a 61 6e | 64 20 74 68 65 69 72 20 |s and.an|d their |
|00001960| 64 65 73 63 72 69 70 74 | 69 6f 6e 3a 20 54 68 65 |descript|ion: The|
|00001970| 20 40 63 6f 64 65 7b 63 | 61 74 61 6c 6f 67 20 64 | @code{c|atalog d|
|00001980| 65 73 63 72 69 70 74 69 | 6f 6e 7d 2e 20 54 68 65 |escripti|on}. The|
|00001990| 20 64 65 73 63 72 69 70 | 74 69 6f 6e 0a 63 6f 6e | descrip|tion.con|
|000019a0| 73 69 73 74 73 20 6f 66 | 20 74 68 65 20 73 74 72 |sists of| the str|
|000019b0| 69 6e 67 20 69 74 73 65 | 6c 66 2c 20 61 6e 20 69 |ing itse|lf, an i|
|000019c0| 64 65 6e 74 69 66 69 65 | 72 20 77 68 69 63 68 20 |dentifie|r which |
|000019d0| 69 73 20 75 73 65 64 20 | 69 6e 20 74 68 65 20 70 |is used |in the p|
|000019e0| 72 6f 67 72 61 6d 0a 69 | 6e 20 70 6c 61 63 65 20 |rogram.i|n place |
|000019f0| 6f 66 20 74 68 65 20 73 | 74 72 69 6e 67 20 61 6e |of the s|tring an|
|00001a00| 64 20 69 6e 66 6f 72 6d | 61 74 69 6f 6e 73 20 6f |d inform|ations o|
|00001a10| 6e 20 74 68 65 20 73 74 | 72 69 6e 67 73 20 6d 69 |n the st|rings mi|
|00001a20| 6e 69 6d 61 6c 20 61 6e | 64 20 6d 61 78 69 6d 61 |nimal an|d maxima|
|00001a30| 6c 0a 6c 65 6e 67 74 68 | 2e 20 40 78 72 65 66 7b |l.length|. @xref{|
|00001a40| 43 61 74 61 6c 6f 67 20 | 64 65 73 63 72 69 70 74 |Catalog |descript|
|00001a50| 69 6f 6e 7d 2e 0a 40 69 | 74 65 6d 20 41 20 40 63 |ion}..@i|tem A @c|
|00001a60| 6f 64 65 7b 73 6f 75 72 | 63 65 20 64 65 73 63 72 |ode{sour|ce descr|
|00001a70| 69 70 74 69 6f 6e 7d 20 | 66 69 6c 65 20 69 73 20 |iption} |file is |
|00001a80| 75 73 65 64 20 74 6f 20 | 63 72 65 61 74 65 20 73 |used to |create s|
|00001a90| 6f 75 72 63 65 20 66 72 | 6f 6d 20 74 68 65 0a 63 |ource fr|om the.c|
|00001aa0| 61 74 61 6c 6f 67 20 64 | 65 73 63 72 69 70 74 69 |atalog d|escripti|
|00001ab0| 6f 6e 3a 20 54 68 69 73 | 20 69 73 20 61 20 74 65 |on: This| is a te|
|00001ac0| 6d 70 6c 61 74 65 20 66 | 69 6c 65 20 63 6f 6e 74 |mplate f|ile cont|
|00001ad0| 61 69 6e 69 6e 67 20 63 | 65 72 74 61 69 6e 20 70 |aining c|ertain p|
|00001ae0| 61 74 74 65 72 6e 73 0a | 77 68 69 63 68 20 61 72 |atterns.|which ar|
|00001af0| 65 20 73 75 62 73 74 69 | 74 75 74 65 64 20 77 69 |e substi|tuted wi|
|00001b00| 74 68 20 70 72 65 64 65 | 66 69 6e 65 64 20 76 61 |th prede|fined va|
|00001b10| 6c 75 65 73 2c 20 66 6f | 72 20 65 78 61 6d 70 6c |lues, fo|r exampl|
|00001b20| 65 20 74 68 65 20 73 74 | 72 69 6e 67 73 2e 0a 54 |e the st|rings..T|
|00001b30| 68 69 73 20 73 6f 75 72 | 63 65 20 64 65 73 63 72 |his sour|ce descr|
|00001b40| 69 70 74 69 6f 6e 20 63 | 61 6e 20 62 65 20 65 64 |iption c|an be ed|
|00001b50| 69 74 65 64 20 61 6e 64 | 20 68 65 6e 63 65 20 61 |ited and| hence a|
|00001b60| 64 61 70 74 65 64 20 74 | 6f 20 61 6e 79 20 70 72 |dapted t|o any pr|
|00001b70| 6f 67 72 61 6d 6d 69 6e | 67 0a 6c 61 6e 67 75 61 |ogrammin|g.langua|
|00001b80| 67 65 20 61 6e 64 20 61 | 6e 79 20 69 6e 64 69 76 |ge and a|ny indiv|
|00001b90| 69 64 75 61 6c 20 6e 65 | 65 64 73 2e 20 53 6f 6d |idual ne|eds. Som|
|00001ba0| 65 20 73 6f 75 72 63 65 | 20 64 65 73 63 72 69 70 |e source| descrip|
|00001bb0| 74 69 6f 6e 73 20 28 41 | 73 73 65 6d 62 6c 65 72 |tions (A|ssembler|
|00001bc0| 2c 0a 4f 62 65 72 6f 6e | 20 61 6e 64 20 43 2c 20 |,.Oberon| and C, |
|00001bd0| 74 68 65 20 6c 61 74 74 | 65 72 20 61 6c 6c 6f 77 |the latt|er allow|
|00001be0| 69 6e 67 20 6c 6f 63 61 | 6c 69 7a 69 6e 67 20 75 |ing loca|lizing u|
|00001bf0| 6e 64 65 72 20 32 2e 30 | 20 6f 72 20 32 2e 31 20 |nder 2.0| or 2.1 |
|00001c00| 61 6e 64 20 61 62 6f 76 | 65 29 20 61 72 65 0a 61 |and abov|e) are.a|
|00001c10| 6c 72 65 61 64 79 20 70 | 61 72 74 20 6f 66 20 74 |lready p|art of t|
|00001c20| 68 65 20 46 6c 65 78 43 | 61 74 20 64 69 73 74 72 |he FlexC|at distr|
|00001c30| 69 62 75 74 69 6f 6e 2e | 20 54 68 65 73 65 20 63 |ibution.| These c|
|00001c40| 61 6e 20 62 65 20 75 73 | 65 64 20 61 73 20 65 78 |an be us|ed as ex|
|00001c50| 61 6d 70 6c 65 73 0a 6f | 72 20 61 73 20 74 68 65 |amples.o|r as the|
|00001c60| 79 20 61 72 65 20 77 69 | 74 68 6f 75 74 20 61 6e |y are wi|thout an|
|00001c70| 79 20 66 75 72 74 68 65 | 72 20 74 68 69 6e 6b 69 |y furthe|r thinki|
|00001c80| 6e 67 2e 20 40 78 72 65 | 66 7b 53 6f 75 72 63 65 |ng. @xre|f{Source|
|00001c90| 20 64 65 73 63 72 69 70 | 74 69 6f 6e 7d 2e 0a 40 | descrip|tion}..@|
|00001ca0| 69 74 65 6d 20 55 73 69 | 6e 67 20 46 6c 65 78 43 |item Usi|ng FlexC|
|00001cb0| 61 74 20 79 6f 75 20 63 | 72 65 61 74 65 20 61 20 |at you c|reate a |
|00001cc0| 73 6f 20 63 61 6c 6c 65 | 64 20 40 63 6f 64 65 7b |so calle|d @code{|
|00001cd0| 63 61 74 61 6c 6f 67 20 | 74 72 61 6e 73 6c 61 74 |catalog |translat|
|00001ce0| 69 6f 6e 7d 20 66 69 6c | 65 0a 66 6f 72 20 65 76 |ion} fil|e.for ev|
|00001cf0| 65 72 79 20 61 64 64 69 | 74 69 6f 6e 61 6c 20 6c |ery addi|tional l|
|00001d00| 61 6e 67 75 61 67 65 2e | 20 54 68 65 73 65 20 61 |anguage.| These a|
|00001d10| 72 65 20 76 65 72 79 20 | 73 69 6d 69 6c 61 72 20 |re very |similar |
|00001d20| 74 6f 20 74 68 65 20 63 | 61 74 61 6c 6f 67 0a 64 |to the c|atalog.d|
|00001d30| 65 73 63 72 69 70 74 69 | 6f 6e 20 65 78 63 65 70 |escripti|on excep|
|00001d40| 74 20 74 68 61 74 20 74 | 68 65 79 20 63 6f 6e 74 |t that t|hey cont|
|00001d50| 61 69 6e 20 65 6d 70 74 | 79 20 6c 69 6e 65 73 20 |ain empt|y lines |
|00001d60| 69 6e 73 74 65 61 64 20 | 6f 66 20 74 68 65 20 73 |instead |of the s|
|00001d70| 74 72 69 6e 67 73 0a 61 | 6e 64 20 6d 69 73 73 20 |trings.a|nd miss |
|00001d80| 74 68 65 20 73 74 72 69 | 6e 67 20 64 65 73 63 72 |the stri|ng descr|
|00001d90| 69 70 74 69 6f 6e 20 77 | 68 69 63 68 20 69 73 20 |iption w|hich is |
|00001da0| 73 74 69 6c 6c 20 70 61 | 72 74 20 6f 66 20 74 68 |still pa|rt of th|
|00001db0| 65 20 63 61 74 61 6c 6f | 67 0a 64 65 73 63 72 69 |e catalo|g.descri|
|00001dc0| 70 74 69 6f 6e 2e 20 41 | 6c 6c 20 79 6f 75 20 6e |ption. A|ll you n|
|00001dd0| 65 65 64 20 74 6f 20 64 | 6f 20 69 73 20 72 65 70 |eed to d|o is rep|
|00001de0| 6c 61 63 65 20 74 68 65 | 20 65 6d 70 74 79 20 6c |lace the| empty l|
|00001df0| 69 6e 65 73 20 77 69 74 | 68 20 74 68 65 0a 72 65 |ines wit|h the.re|
|00001e00| 73 70 65 63 74 69 76 65 | 20 73 74 72 69 6e 67 73 |spective| strings|
|00001e10| 20 69 6e 20 74 68 65 20 | 6e 65 77 20 6c 61 6e 67 | in the |new lang|
|00001e20| 75 61 67 65 2e 20 46 6c | 65 78 43 61 74 20 6d 61 |uage. Fl|exCat ma|
|00001e30| 6b 65 73 20 74 68 69 73 | 20 65 61 73 79 20 62 79 |kes this| easy by|
|00001e40| 20 61 64 64 69 6e 67 0a | 74 68 65 20 6f 72 69 67 | adding.|the orig|
|00001e50| 69 6e 61 6c 20 73 74 72 | 69 6e 67 73 20 61 73 20 |inal str|ings as |
|00001e60| 63 6f 6d 6d 65 6e 74 20 | 6c 69 6e 65 73 2c 20 68 |comment |lines, h|
|00001e70| 65 6e 63 65 20 69 74 20 | 69 73 20 63 6c 65 61 72 |ence it |is clear|
|00001e80| 2c 20 77 68 61 74 20 77 | 6f 72 64 73 20 79 6f 75 |, what w|ords you|
|00001e90| 0a 73 68 6f 75 6c 64 20 | 69 6e 73 65 72 74 2e 20 |.should |insert. |
|00001ea0| 46 69 6e 61 6c 6c 79 20 | 46 6c 65 78 43 61 74 20 |Finally |FlexCat |
|00001eb0| 69 73 20 75 73 65 64 20 | 61 67 61 69 6e 20 74 6f |is used |again to|
|00001ec0| 20 63 72 65 61 74 65 20 | 61 20 40 63 6f 64 65 7b | create |a @code{|
|00001ed0| 63 61 74 61 6c 6f 67 7d | 20 66 69 6c 65 0a 66 72 |catalog}| file.fr|
|00001ee0| 6f 6d 20 74 68 65 20 63 | 61 74 61 6c 6f 67 20 64 |om the c|atalog d|
|00001ef0| 65 73 63 72 69 70 74 69 | 6f 6e 20 61 6e 64 20 74 |escripti|on and t|
|00001f00| 68 65 20 63 61 74 61 6c | 6f 67 20 74 72 61 6e 73 |he catal|og trans|
|00001f10| 6c 61 74 69 6f 6e 2e 20 | 28 54 68 69 73 20 63 61 |lation. |(This ca|
|00001f20| 6e 20 62 65 20 64 6f 6e | 65 0a 61 74 20 61 6e 79 |n be don|e.at any|
|00001f30| 20 74 69 6d 65 2c 20 65 | 76 65 6e 20 69 66 20 74 | time, e|ven if t|
|00001f40| 68 65 20 70 72 6f 67 72 | 61 6d 20 69 73 20 66 69 |he progr|am is fi|
|00001f50| 6e 69 73 68 65 64 20 77 | 69 74 68 6f 75 74 20 61 |nished w|ithout a|
|00001f60| 6e 79 20 63 68 61 6e 67 | 65 73 2e 29 0a 40 78 72 |ny chang|es.).@xr|
|00001f70| 65 66 7b 43 61 74 61 6c | 6f 67 20 74 72 61 6e 73 |ef{Catal|og trans|
|00001f80| 6c 61 74 69 6f 6e 7d 2e | 0a 40 65 6e 64 20 65 6e |lation}.|.@end en|
|00001f90| 75 6d 65 72 61 74 65 0a | 0a 0a 0a 40 6e 6f 64 65 |umerate.|...@node|
|00001fa0| 20 49 6e 73 74 61 6c 6c | 61 74 69 6f 6e 0a 40 63 | Install|ation.@c|
|00001fb0| 68 61 70 74 65 72 20 49 | 6e 73 74 61 6c 6c 61 74 |hapter I|nstallat|
|00001fc0| 69 6f 6e 0a 40 63 69 6e | 64 65 78 20 49 6e 73 74 |ion.@cin|dex Inst|
|00001fd0| 61 6c 6c 61 74 69 6f 6e | 0a 40 63 69 6e 64 65 78 |allation|.@cindex|
|00001fe0| 20 52 65 71 75 69 72 65 | 6d 65 6e 74 73 0a 46 6c | Require|ments.Fl|
|00001ff0| 65 78 43 61 74 20 69 73 | 20 77 72 69 74 74 65 6e |exCat is| written|
|00002000| 20 69 6e 20 70 75 72 65 | 20 41 6e 73 69 69 2d 43 | in pure| Ansii-C|
|00002010| 20 28 65 78 63 65 70 74 | 20 66 6f 72 20 74 68 65 | (except| for the|
|00002020| 20 6c 6f 63 61 6c 69 7a | 61 74 69 6f 6e 29 2c 20 | localiz|ation), |
|00002030| 68 65 6e 63 65 20 69 74 | 0a 73 68 6f 75 6c 64 20 |hence it|.should |
|00002040| 72 75 6e 20 6f 6e 20 61 | 6e 79 20 41 6d 69 67 61 |run on a|ny Amiga|
|00002050| 20 61 6e 64 20 68 6f 70 | 65 66 75 6c 6c 79 20 6f | and hop|efully o|
|00002060| 6e 20 6f 74 68 65 72 20 | 6d 61 63 68 69 6e 65 73 |n other |machines|
|00002070| 20 61 66 74 65 72 20 72 | 65 63 6f 6d 70 69 6c 69 | after r|ecompili|
|00002080| 6e 67 2e 0a 28 54 68 65 | 20 6c 6f 63 61 6c 69 7a |ng..(The| localiz|
|00002090| 69 6e 67 20 69 73 20 63 | 6f 6d 6d 65 6e 74 65 64 |ing is c|ommented|
|000020a0| 20 6f 75 74 20 69 6e 20 | 74 68 61 74 20 63 61 73 | out in |that cas|
|000020b0| 65 2e 29 20 54 68 69 73 | 20 68 6f 6c 64 73 20 66 |e.) This| holds f|
|000020c0| 6f 72 20 74 68 65 20 63 | 72 65 61 74 65 64 0a 70 |or the c|reated.p|
|000020d0| 72 6f 67 72 61 6d 73 20 | 74 6f 6f 3a 20 46 6c 65 |rograms |too: Fle|
|000020e0| 78 43 61 74 20 69 73 20 | 77 72 69 74 74 65 6e 20 |xCat is |written |
|000020f0| 75 73 69 6e 67 20 69 74 | 73 65 6c 66 2e 20 41 6c |using it|self. Al|
|00002100| 6c 20 64 69 73 74 72 69 | 62 75 74 65 64 20 73 6f |l distri|buted so|
|00002110| 75 72 63 65 0a 64 65 73 | 63 72 69 70 74 69 6f 6e |urce.des|cription|
|00002120| 73 20 73 68 6f 75 6c 64 | 20 63 72 65 61 74 65 20 |s should| create |
|00002130| 70 72 6f 67 72 61 6d 73 | 20 72 75 6e 6e 69 6e 67 |programs| running|
|00002140| 20 6f 6e 20 61 6e 79 20 | 41 6d 69 67 61 20 61 6e | on any |Amiga an|
|00002150| 64 20 65 76 65 6e 20 61 | 6e 79 0a 6d 61 63 68 69 |d even a|ny.machi|
|00002160| 6e 65 2e 20 28 4f 66 20 | 63 6f 75 72 73 65 20 79 |ne. (Of |course y|
|00002170| 6f 75 20 6d 75 73 74 20 | 65 6e 73 75 72 65 20 74 |ou must |ensure t|
|00002180| 68 61 74 20 74 68 65 20 | 76 61 72 69 61 62 6c 65 |hat the |variable|
|00002190| 20 4c 6f 63 61 6c 65 42 | 61 73 65 20 68 61 73 20 | LocaleB|ase has |
|000021a0| 74 68 65 0a 76 61 6c 75 | 65 20 40 73 61 6d 70 7b |the.valu|e @samp{|
|000021b0| 4e 55 4c 4c 7d 20 69 6e | 20 74 68 65 20 6c 61 74 |NULL} in| the lat|
|000021c0| 74 65 72 20 63 61 73 65 | 2e 29 20 4c 6f 63 61 6c |ter case|.) Local|
|000021d0| 69 7a 69 6e 67 2c 20 68 | 6f 77 65 76 65 72 2c 20 |izing, h|owever, |
|000021e0| 69 73 20 70 6f 73 73 69 | 62 6c 65 0a 62 65 67 69 |is possi|ble.begi|
|000021f0| 6e 6e 69 6e 67 20 77 69 | 74 68 20 57 6f 72 6b 62 |nning wi|th Workb|
|00002200| 65 6e 63 68 20 32 2e 31 | 20 62 65 63 61 75 73 65 |ench 2.1| because|
|00002210| 20 74 68 65 20 40 63 6f | 64 65 7b 6c 6f 63 61 6c | the @co|de{local|
|00002220| 65 2e 6c 69 62 72 61 72 | 79 7d 20 69 73 6e 27 74 |e.librar|y} isn't|
|00002230| 0a 61 76 61 69 6c 61 62 | 6c 65 20 62 65 6c 6f 77 |.availab|le below|
|00002240| 2e 0a 0a 49 74 20 69 73 | 20 6e 6f 74 20 69 6d 70 |...It is| not imp|
|00002250| 6f 73 73 69 62 6c 65 20 | 74 6f 20 6f 66 66 65 72 |ossible |to offer|
|00002260| 20 6c 6f 63 61 6c 69 7a | 69 6e 67 20 77 69 74 68 | localiz|ing with|
|00002270| 6f 75 74 20 74 68 65 20 | 40 63 6f 64 65 7b 6c 6f |out the |@code{lo|
|00002280| 63 61 6c 65 2e 6c 69 62 | 72 61 72 79 7d 3a 0a 54 |cale.lib|rary}:.T|
|00002290| 68 65 20 73 6f 75 72 63 | 65 20 64 65 73 63 72 69 |he sourc|e descri|
|000022a0| 70 74 69 6f 6e 20 66 69 | 6c 65 73 20 40 66 69 6c |ption fi|les @fil|
|000022b0| 65 7b 43 5f 63 5f 56 32 | 30 2e 73 64 7d 20 61 6e |e{C_c_V2|0.sd} an|
|000022c0| 64 20 40 66 69 6c 65 7b | 43 5f 68 5f 56 32 30 2e |d @file{|C_h_V20.|
|000022d0| 73 64 7d 20 67 69 76 65 | 0a 61 6e 20 65 78 61 6d |sd} give|.an exam|
|000022e0| 70 6c 65 2c 20 77 68 65 | 72 65 20 74 68 65 20 40 |ple, whe|re the @|
|000022f0| 63 6f 64 65 7b 69 66 66 | 70 61 72 73 65 2e 6c 69 |code{iff|parse.li|
|00002300| 62 72 61 72 79 7d 20 69 | 73 20 75 73 65 64 20 74 |brary} i|s used t|
|00002310| 6f 20 72 65 70 6c 61 63 | 65 20 74 68 65 0a 40 63 |o replac|e the.@c|
|00002320| 6f 64 65 7b 6c 6f 63 61 | 6c 65 2e 6c 69 62 72 61 |ode{loca|le.libra|
|00002330| 72 79 7d 2c 20 69 66 20 | 69 74 20 69 73 20 6e 6f |ry}, if |it is no|
|00002340| 74 20 61 76 61 69 6c 61 | 62 6c 65 2e 20 54 68 69 |t availa|ble. Thi|
|00002350| 73 20 67 69 76 65 73 20 | 4c 6f 63 61 6c 69 7a 69 |s gives |Localizi|
|00002360| 6e 67 20 66 6f 72 0a 57 | 6f 72 6b 62 65 6e 63 68 |ng for.W|orkbench|
|00002370| 20 32 2e 30 2e 20 40 78 | 72 65 66 7b 43 7d 2e 0a | 2.0. @x|ref{C}..|
|00002380| 0a 49 6e 73 74 61 6c 6c | 69 6e 67 20 46 6c 65 78 |.Install|ing Flex|
|00002390| 43 61 74 20 69 73 20 73 | 69 6d 70 6c 65 3a 20 4a |Cat is s|imple: J|
|000023a0| 75 73 74 20 63 6f 70 79 | 20 74 68 65 20 70 72 6f |ust copy| the pro|
|000023b0| 67 72 61 6d 20 74 6f 20 | 61 20 64 69 72 65 63 74 |gram to |a direct|
|000023c0| 6f 72 79 20 69 6e 20 79 | 6f 75 72 0a 73 65 61 72 |ory in y|our.sear|
|000023d0| 63 68 20 70 61 74 68 20 | 61 6e 64 20 73 65 6c 65 |ch path |and sele|
|000023e0| 63 74 20 61 20 70 6c 61 | 63 65 20 66 6f 72 20 74 |ct a pla|ce for t|
|000023f0| 68 65 20 73 6f 75 72 63 | 65 20 64 65 73 63 72 69 |he sourc|e descri|
|00002400| 70 74 69 6f 6e 73 20 79 | 6f 75 20 6e 65 65 64 2e |ptions y|ou need.|
|00002410| 0a 28 54 68 65 73 65 20 | 61 72 65 20 74 68 65 20 |.(These |are the |
|00002420| 66 69 6c 65 73 20 63 61 | 6c 6c 65 64 20 73 6f 6d |files ca|lled som|
|00002430| 65 74 68 69 6e 67 20 6c | 69 6b 65 20 40 66 69 6c |ething l|ike @fil|
|00002440| 65 7b 78 78 5f 79 79 2e | 73 64 7d 2c 20 77 68 65 |e{xx_yy.|sd}, whe|
|00002450| 72 65 20 40 66 69 6c 65 | 7b 78 78 7d 0a 69 73 20 |re @file|{xx}.is |
|00002460| 74 68 65 20 70 72 6f 67 | 72 61 6d 6d 69 6e 67 20 |the prog|ramming |
|00002470| 6c 61 6e 67 75 61 67 65 | 2e 29 20 49 66 20 79 6f |language|.) If yo|
|00002480| 75 20 77 61 6e 74 20 74 | 6f 20 75 73 65 20 46 6c |u want t|o use Fl|
|00002490| 65 78 43 61 74 20 69 6e | 20 61 6e 6f 74 68 65 72 |exCat in| another|
|000024a0| 20 6c 61 6e 67 75 61 67 | 65 0a 74 68 61 6e 20 74 | languag|e.than t|
|000024b0| 68 65 20 65 6e 67 6c 69 | 73 68 20 79 6f 75 20 6e |he engli|sh you n|
|000024c0| 65 65 64 20 74 6f 20 63 | 6f 70 79 20 74 68 65 20 |eed to c|opy the |
|000024d0| 72 65 73 70 65 63 74 69 | 76 65 20 63 61 74 61 6c |respecti|ve catal|
|000024e0| 6f 67 20 66 69 6c 65 73 | 20 74 6f 6f 2e 20 46 6f |og files| too. Fo|
|000024f0| 72 0a 74 68 65 20 67 65 | 72 6d 61 6e 20 6c 61 6e |r.the ge|rman lan|
|00002500| 67 75 61 67 65 20 66 6f | 72 20 65 78 61 6d 70 6c |guage fo|r exampl|
|00002510| 65 20 28 61 63 74 75 61 | 6c 6c 79 20 74 68 69 73 |e (actua|lly this|
|00002520| 20 69 73 20 74 68 65 20 | 6f 6e 6c 79 20 6f 6e 65 | is the |only one|
|00002530| 20 61 76 61 69 6c 61 62 | 6c 65 29 0a 63 6f 70 79 | availab|le).copy|
|00002540| 20 74 68 65 20 66 69 6c | 65 20 40 66 69 6c 65 7b | the fil|e @file{|
|00002550| 43 61 74 61 6c 6f 67 73 | 2f 44 65 75 74 73 63 68 |Catalogs|/Deutsch|
|00002560| 2f 46 6c 65 78 43 61 74 | 2e 63 61 74 61 6c 6f 67 |/FlexCat|.catalog|
|00002570| 7d 20 74 6f 0a 40 66 69 | 6c 65 7b 4c 6f 63 61 6c |} to.@fi|le{Local|
|00002580| 65 3a 43 61 74 61 6c 6f | 67 73 2f 44 65 75 74 73 |e:Catalo|gs/Deuts|
|00002590| 63 68 2f 46 6c 65 78 43 | 61 74 2e 63 61 74 61 6c |ch/FlexC|at.catal|
|000025a0| 6f 67 7d 20 6f 72 20 74 | 6f 0a 40 66 69 6c 65 7b |og} or t|o.@file{|
|000025b0| 50 52 4f 47 44 49 52 3a | 43 61 74 61 6c 6f 67 73 |PROGDIR:|Catalogs|
|000025c0| 2f 44 65 75 74 73 63 68 | 2f 46 6c 65 78 43 61 74 |/Deutsch|/FlexCat|
|000025d0| 2e 63 61 74 61 6c 6f 67 | 7d 2c 20 77 68 65 72 65 |.catalog|}, where|
|000025e0| 20 40 66 69 6c 65 7b 50 | 52 4f 47 44 49 52 3a 7d | @file{P|ROGDIR:}|
|000025f0| 0a 69 73 20 46 6c 65 78 | 43 61 74 27 73 20 70 72 |.is Flex|Cat's pr|
|00002600| 6f 67 72 61 6d 20 64 69 | 72 65 63 74 6f 72 79 2e |ogram di|rectory.|
|00002610| 20 40 78 72 65 66 7b 55 | 73 69 6e 67 20 46 6c 65 | @xref{U|sing Fle|
|00002620| 78 43 61 74 20 73 6f 75 | 72 63 65 7d 2e 0a 0a 0a |xCat sou|rce}....|
|00002630| 0a 40 6e 6f 64 65 20 50 | 72 6f 67 72 61 6d 20 73 |.@node P|rogram s|
|00002640| 74 61 72 74 0a 40 63 68 | 61 70 74 65 72 20 43 61 |tart.@ch|apter Ca|
|00002650| 6c 6c 69 6e 67 20 46 6c | 65 78 43 61 74 20 66 72 |lling Fl|exCat fr|
|00002660| 6f 6d 20 74 68 65 20 43 | 4c 49 0a 40 63 69 6e 64 |om the C|LI.@cind|
|00002670| 65 78 20 43 4c 49 0a 40 | 63 69 6e 64 65 78 20 57 |ex CLI.@|cindex W|
|00002680| 6f 72 6b 62 65 6e 63 68 | 0a 46 6c 65 78 43 61 74 |orkbench|.FlexCat|
|00002690| 20 69 73 20 61 20 43 4c | 49 20 62 61 73 65 64 20 | is a CL|I based |
|000026a0| 70 72 6f 67 72 61 6d 20 | 61 6e 64 20 64 6f 65 73 |program |and does|
|000026b0| 6e 27 74 20 6f 70 65 72 | 61 74 65 20 66 72 6f 6d |n't oper|ate from|
|000026c0| 20 74 68 65 20 77 6f 72 | 6b 62 65 6e 63 68 2e 0a | the wor|kbench..|
|000026d0| 49 74 27 73 20 63 61 6c | 6c 69 6e 67 20 73 79 6e |It's cal|ling syn|
|000026e0| 74 61 78 20 69 73 0a 40 | 65 78 61 6d 70 6c 65 0a |tax is.@|example.|
|000026f0| 20 20 20 20 46 6c 65 78 | 43 61 74 20 43 44 46 49 | Flex|Cat CDFI|
|00002700| 4c 45 2f 61 2c 43 54 46 | 49 4c 45 2c 43 41 54 41 |LE/a,CTF|ILE,CATA|
|00002710| 4c 4f 47 2f 6b 2c 4e 45 | 57 43 54 46 49 4c 45 2f |LOG/k,NE|WCTFILE/|
|00002720| 6b 2c 53 4f 55 52 43 45 | 53 2f 6d 0a 40 65 6e 64 |k,SOURCE|S/m.@end|
|00002730| 20 65 78 61 6d 70 6c 65 | 0a 40 6e 6f 69 6e 64 65 | example|.@noinde|
|00002740| 6e 74 0a 77 68 65 72 65 | 20 74 68 65 20 61 72 67 |nt.where| the arg|
|00002750| 75 6d 65 6e 74 73 20 6d | 65 61 6e 0a 40 74 61 62 |uments m|ean.@tab|
|00002760| 6c 65 20 40 73 74 72 6f | 6e 67 0a 40 69 74 65 6d |le @stro|ng.@item|
|00002770| 20 43 44 46 49 4c 45 0a | 69 73 20 74 68 65 20 6e | CDFILE.|is the n|
|00002780| 61 6d 65 20 6f 66 20 61 | 20 63 61 74 61 6c 6f 67 |ame of a| catalog|
|00002790| 20 64 65 73 63 72 69 70 | 74 69 6f 6e 20 74 6f 20 | descrip|tion to |
|000027a0| 62 65 20 72 65 61 64 2e | 20 54 68 69 73 20 69 73 |be read.| This is|
|000027b0| 20 61 6c 77 61 79 73 20 | 6e 65 65 64 65 64 2e 0a | always |needed..|
|000027c0| 50 6c 65 61 73 65 20 6e | 6f 74 2c 20 74 68 61 74 |Please n|ot, that|
|000027d0| 20 74 68 65 20 62 61 73 | 65 20 6e 61 6d 65 20 6f | the bas|e name o|
|000027e0| 66 20 74 68 65 20 73 6f | 75 72 63 65 20 64 65 73 |f the so|urce des|
|000027f0| 63 72 69 70 74 69 6f 6e | 20 69 73 20 63 72 65 61 |cription| is crea|
|00002800| 74 65 64 20 66 72 6f 6d | 0a 69 74 20 65 6e 64 20 |ted from|.it end |
|00002810| 68 65 6e 63 65 20 74 68 | 69 73 20 69 73 20 63 61 |hence th|is is ca|
|00002820| 73 65 20 73 69 67 6e 69 | 66 69 63 61 6e 74 2e 20 |se signi|ficant. |
|00002830| 40 78 72 65 66 7b 53 6f | 75 72 63 65 20 64 65 73 |@xref{So|urce des|
|00002840| 63 72 69 70 74 69 6f 6e | 7d 2e 0a 40 69 74 65 6d |cription|}..@item|
|00002850| 20 43 54 46 49 4c 45 0a | 69 73 20 74 68 65 20 6e | CTFILE.|is the n|
|00002860| 61 6d 65 20 6f 66 20 61 | 20 63 61 74 61 6c 6f 67 |ame of a| catalog|
|00002870| 20 74 72 61 6e 73 6c 61 | 74 69 6f 6e 20 66 69 6c | transla|tion fil|
|00002880| 65 20 74 6f 20 62 65 20 | 72 65 61 64 2e 20 54 68 |e to be |read. Th|
|00002890| 69 73 20 69 73 20 6e 65 | 65 64 65 64 20 66 6f 72 |is is ne|eded for|
|000028a0| 0a 63 72 65 61 74 69 6e | 67 20 63 61 74 61 6c 6f |.creatin|g catalo|
|000028b0| 67 73 20 6f 72 20 66 6f | 72 20 75 70 64 61 74 69 |gs or fo|r updati|
|000028c0| 6e 67 20 61 6e 20 6f 6c | 64 20 63 61 74 61 6c 6f |ng an ol|d catalo|
|000028d0| 67 20 74 72 61 6e 73 6c | 61 74 69 6f 6e 20 66 69 |g transl|ation fi|
|000028e0| 6c 65 20 75 73 69 6e 67 | 0a 74 68 65 20 4e 45 57 |le using|.the NEW|
|000028f0| 43 54 46 49 4c 45 20 61 | 72 67 75 6d 65 6e 74 3a |CTFILE a|rgument:|
|00002900| 20 46 6c 65 78 43 61 74 | 20 72 65 61 64 73 20 74 | FlexCat| reads t|
|00002910| 68 65 20 6f 6c 64 20 66 | 69 6c 65 20 61 6e 64 20 |he old f|ile and |
|00002920| 74 68 65 20 63 61 74 61 | 6c 6f 67 0a 64 65 73 63 |the cata|log.desc|
|00002930| 72 69 70 74 69 6f 6e 20 | 61 6e 64 20 63 72 65 61 |ription |and crea|
|00002940| 74 65 73 20 61 20 6e 65 | 77 20 63 61 74 61 6c 6f |tes a ne|w catalo|
|00002950| 67 20 74 72 61 6e 73 6c | 61 74 69 6f 6e 20 66 69 |g transl|ation fi|
|00002960| 6c 65 20 63 6f 6e 74 61 | 69 6e 69 6e 67 20 74 68 |le conta|ining th|
|00002970| 65 0a 6f 6c 64 20 73 74 | 72 69 6e 67 73 20 61 6e |e.old st|rings an|
|00002980| 64 20 70 6f 73 73 69 62 | 6c 79 20 73 6f 6d 65 20 |d possib|ly some |
|00002990| 65 6d 70 74 79 20 6c 69 | 6e 65 73 20 66 6f 72 20 |empty li|nes for |
|000029a0| 6e 65 77 20 73 74 72 69 | 6e 67 73 2e 0a 40 69 74 |new stri|ngs..@it|
|000029b0| 65 6d 20 43 41 54 41 4c | 4f 47 0a 69 73 20 74 68 |em CATAL|OG.is th|
|000029c0| 65 20 6e 61 6d 65 20 6f | 66 20 61 20 63 61 74 61 |e name o|f a cata|
|000029d0| 6c 6f 67 20 66 69 6c 65 | 20 74 6f 20 62 65 20 63 |log file| to be c|
|000029e0| 72 65 61 74 65 64 2e 20 | 54 68 69 73 20 61 72 67 |reated. |This arg|
|000029f0| 75 6d 65 6e 74 20 72 65 | 71 75 69 72 65 73 20 67 |ument re|quires g|
|00002a00| 69 76 69 6e 67 0a 43 44 | 46 49 4c 45 20 61 73 20 |iving.CD|FILE as |
|00002a10| 77 65 6c 6c 2e 0a 40 69 | 74 65 6d 20 4e 45 57 43 |well..@i|tem NEWC|
|00002a20| 54 46 49 4c 45 0a 69 73 | 20 74 68 65 20 6e 61 6d |TFILE.is| the nam|
|00002a30| 65 20 6f 66 20 61 20 63 | 61 74 61 6c 6f 67 20 74 |e of a c|atalog t|
|00002a40| 72 61 6e 73 6c 61 74 69 | 6f 6e 20 66 69 6c 65 20 |ranslati|on file |
|00002a50| 74 6f 20 63 72 65 61 74 | 65 2e 20 46 6c 65 78 43 |to creat|e. FlexC|
|00002a60| 61 74 20 72 65 61 64 73 | 20 73 74 72 69 6e 67 73 |at reads| strings|
|00002a70| 0a 66 72 6f 6d 20 43 54 | 46 49 4c 45 2c 20 69 66 |.from CT|FILE, if|
|00002a80| 20 74 68 69 73 20 69 73 | 20 67 69 76 65 6e 2c 20 | this is| given, |
|00002a90| 73 74 72 69 6e 67 73 20 | 6d 69 73 73 69 6e 67 20 |strings |missing |
|00002aa0| 69 6e 20 74 68 65 20 63 | 61 74 61 6c 6f 67 20 74 |in the c|atalog t|
|00002ab0| 72 61 6e 73 6c 61 74 69 | 6f 6e 0a 61 72 65 20 72 |ranslati|on.are r|
|00002ac0| 65 70 6c 61 63 65 64 20 | 62 79 20 65 6d 70 74 79 |eplaced |by empty|
|00002ad0| 20 6c 69 6e 65 73 2e 20 | 28 54 68 65 20 6e 65 77 | lines. |(The new|
|00002ae0| 20 63 61 74 61 6c 6f 67 | 20 74 72 61 6e 73 6c 61 | catalog| transla|
|00002af0| 74 69 6f 6e 20 77 69 6c | 6c 20 63 6f 6e 74 61 69 |tion wil|l contai|
|00002b00| 6e 0a 6f 6e 6c 79 20 65 | 6d 70 74 79 20 6c 69 6e |n.only e|mpty lin|
|00002b10| 65 73 20 61 73 20 73 74 | 72 69 6e 67 73 2c 20 69 |es as st|rings, i|
|00002b20| 66 20 43 54 46 49 4c 45 | 20 69 73 20 6f 6d 69 74 |f CTFILE| is omit|
|00002b30| 74 65 64 2e 29 0a 40 69 | 74 65 6d 20 53 4f 55 52 |ted.).@i|tem SOUR|
|00002b40| 43 45 53 0a 61 72 65 20 | 74 68 65 20 6e 61 6d 65 |CES.are |the name|
|00002b50| 73 20 6f 66 20 73 6f 75 | 72 63 65 20 66 69 6c 65 |s of sou|rce file|
|00002b60| 73 20 74 6f 20 62 65 20 | 63 72 65 61 74 65 64 2e |s to be |created.|
|00002b70| 20 54 68 65 73 65 20 73 | 68 6f 75 64 20 62 65 20 | These s|houd be |
|00002b80| 67 69 76 65 6e 20 69 6e | 20 74 68 65 0a 66 6f 72 |given in| the.for|
|00002b90| 6d 20 40 73 61 6d 70 7b | 73 6f 75 72 63 65 3d 74 |m @samp{|source=t|
|00002ba0| 65 6d 70 6c 61 74 65 7d | 20 77 68 65 72 65 20 40 |emplate}| where @|
|00002bb0| 66 69 6c 65 7b 73 6f 75 | 72 63 65 7d 20 69 73 20 |file{sou|rce} is |
|00002bc0| 74 68 65 20 66 69 6c 65 | 20 74 6f 20 63 72 65 61 |the file| to crea|
|00002bd0| 74 65 20 61 6e 64 0a 40 | 73 61 6d 70 7b 74 65 6d |te and.@|samp{tem|
|00002be0| 70 6c 61 74 65 7d 20 69 | 73 20 74 68 65 20 6e 61 |plate} i|s the na|
|00002bf0| 6d 65 20 6f 66 20 61 20 | 73 6f 75 72 63 65 20 64 |me of a |source d|
|00002c00| 65 73 63 72 69 70 74 69 | 6f 6e 20 66 69 6c 65 20 |escripti|on file |
|00002c10| 74 6f 20 62 65 20 73 63 | 61 6e 6e 65 64 2e 0a 40 |to be sc|anned..@|
|00002c20| 65 6e 64 20 74 61 62 6c | 65 0a 0a 41 6e 20 65 78 |end tabl|e..An ex|
|00002c30| 61 6d 70 6c 65 3a 0a 40 | 65 78 61 6d 70 6c 65 0a |ample:.@|example.|
|00002c40| 40 73 61 6d 70 7b 46 6c | 65 78 43 61 74 20 50 72 |@samp{Fl|exCat Pr|
|00002c50| 6f 67 2e 63 64 20 4e 45 | 57 43 54 46 49 4c 45 20 |og.cd NE|WCTFILE |
|00002c60| 4e 65 77 43 61 74 61 6c | 6f 67 2e 63 74 20 70 72 |NewCatal|og.ct pr|
|00002c70| 6f 67 5f 63 61 74 2e 63 | 3d 43 5f 63 5f 56 32 31 |og_cat.c|=C_c_V21|
|00002c80| 2e 73 64 7d 0a 40 65 6e | 64 20 65 78 61 6d 70 6c |.sd}.@en|d exampl|
|00002c90| 65 0a 40 6e 6f 69 6e 64 | 65 6e 74 0a 72 65 61 64 |e.@noind|ent.read|
|00002ca0| 73 20 74 68 65 20 63 61 | 74 61 6c 6f 67 20 64 65 |s the ca|talog de|
|00002cb0| 73 63 72 69 70 74 69 6f | 6e 20 40 66 69 6c 65 7b |scriptio|n @file{|
|00002cc0| 50 72 6f 67 2e 63 64 7d | 20 61 6e 64 20 63 72 65 |Prog.cd}| and cre|
|00002cd0| 61 74 65 73 20 74 68 65 | 20 63 61 74 61 6c 6f 67 |ates the| catalog|
|00002ce0| 0a 74 72 61 6e 73 6c 61 | 74 69 6f 6e 20 40 66 69 |.transla|tion @fi|
|00002cf0| 6c 65 7b 4e 65 77 43 61 | 74 61 6c 6f 67 2e 63 74 |le{NewCa|talog.ct|
|00002d00| 7d 20 61 6e 64 20 74 68 | 65 20 73 6f 75 72 63 65 |} and th|e source|
|00002d10| 20 66 69 6c 65 20 40 66 | 69 6c 65 7b 70 72 6f 67 | file @f|ile{prog|
|00002d20| 5f 63 61 74 2e 63 7d 20 | 66 72 6f 6d 0a 69 74 2e |_cat.c} |from.it.|
|00002d30| 20 54 68 65 20 6c 61 74 | 74 65 72 20 69 73 20 63 | The lat|ter is c|
|00002d40| 72 65 61 74 65 64 20 75 | 73 69 6e 67 20 74 68 65 |reated u|sing the|
|00002d50| 20 73 6f 75 72 63 65 20 | 64 65 73 63 72 69 70 74 | source |descript|
|00002d60| 69 6f 6e 20 66 69 6c 65 | 0a 40 66 69 6c 65 7b 43 |ion file|.@file{C|
|00002d70| 5f 63 5f 56 32 31 2e 73 | 64 7d 2e 20 54 68 65 20 |_c_V21.s|d}. The |
|00002d80| 62 61 73 65 20 6e 61 6d | 65 20 6f 66 20 74 68 65 |base nam|e of the|
|00002d90| 20 73 6f 75 72 63 65 20 | 64 65 73 63 72 69 70 74 | source |descript|
|00002da0| 69 6f 6e 20 69 73 20 40 | 73 61 6d 70 7b 50 72 6f |ion is @|samp{Pro|
|00002db0| 67 7d 2e 0a 28 50 6c 65 | 61 73 65 20 6e 6f 74 20 |g}..(Ple|ase not |
|00002dc0| 74 68 65 20 75 70 70 65 | 72 63 61 73 65 20 6c 65 |the uppe|rcase le|
|00002dd0| 74 74 65 72 21 29 0a 0a | 0a 0a 40 6e 6f 64 65 20 |tter!)..|..@node |
|00002de0| 43 61 74 61 6c 6f 67 20 | 64 65 73 63 72 69 70 74 |Catalog |descript|
|00002df0| 69 6f 6e 0a 40 63 68 61 | 70 74 65 72 20 43 61 74 |ion.@cha|pter Cat|
|00002e00| 61 6c 6f 67 20 64 65 73 | 63 72 69 70 74 69 6f 6e |alog des|cription|
|00002e10| 20 66 69 6c 65 73 0a 40 | 63 69 6e 64 65 78 20 43 | files.@|cindex C|
|00002e20| 61 74 61 6c 6f 67 20 64 | 65 73 63 72 69 70 74 69 |atalog d|escripti|
|00002e30| 6f 6e 0a 40 63 69 6e 64 | 65 78 20 2e 63 64 0a 41 |on.@cind|ex .cd.A|
|00002e40| 20 63 61 74 61 6c 6f 67 | 20 64 65 73 63 72 69 70 | catalog| descrip|
|00002e50| 74 69 6f 6e 20 66 69 6c | 65 20 63 6f 6e 74 61 69 |tion fil|e contai|
|00002e60| 6e 73 20 66 6f 75 72 20 | 6b 69 6e 64 73 20 6f 66 |ns four |kinds of|
|00002e70| 20 6c 69 6e 65 73 2e 0a | 0a 40 74 61 62 6c 65 20 | lines..|.@table |
|00002e80| 40 73 74 72 6f 6e 67 0a | 40 69 74 65 6d 20 43 6f |@strong.|@item Co|
|00002e90| 6d 6d 65 6e 74 20 6c 69 | 6e 65 73 0a 41 6e 79 20 |mment li|nes.Any |
|00002ea0| 6c 69 6e 65 20 62 65 67 | 69 6e 6e 69 6e 67 20 77 |line beg|inning w|
|00002eb0| 69 74 68 20 61 20 73 65 | 6d 69 63 6f 6c 6f 6e 20 |ith a se|micolon |
|00002ec0| 69 73 20 61 73 73 75 6d | 65 64 20 74 6f 20 62 65 |is assum|ed to be|
|00002ed0| 20 61 20 63 6f 6d 6d 65 | 6e 74 20 6c 69 6e 65 20 | a comme|nt line |
|00002ee0| 61 6e 64 0a 68 65 6e 63 | 65 20 69 67 6e 6f 72 65 |and.henc|e ignore|
|00002ef0| 64 2e 20 28 54 68 65 20 | 73 74 72 69 6e 67 20 6c |d. (The |string l|
|00002f00| 69 6e 65 73 20 62 65 6c | 6f 77 20 61 72 65 20 61 |ines bel|ow are a|
|00002f10| 6e 20 65 78 63 65 70 74 | 69 6f 6e 2e 20 54 68 65 |n except|ion. The|
|00002f20| 73 65 20 6d 61 79 20 62 | 65 67 69 6e 0a 77 69 74 |se may b|egin.wit|
|00002f30| 68 20 61 20 73 65 6d 69 | 63 6f 6c 6f 6e 2e 29 0a |h a semi|colon.).|
|00002f40| 0a 40 69 74 65 6d 20 43 | 6f 6d 6d 61 6e 64 20 6c |.@item C|ommand l|
|00002f50| 69 6e 65 73 0a 41 6e 79 | 20 6c 69 6e 65 20 62 65 |ines.Any| line be|
|00002f60| 67 69 6e 6e 69 6e 67 20 | 77 69 74 68 20 61 20 27 |ginning |with a '|
|00002f70| 23 27 20 28 77 69 74 68 | 20 74 68 65 20 73 61 6d |#' (with| the sam|
|00002f80| 65 20 65 78 63 65 70 74 | 69 6f 6e 20 61 73 20 61 |e except|ion as a|
|00002f90| 62 6f 76 65 29 20 61 72 | 65 0a 61 73 73 75 6d 65 |bove) ar|e.assume|
|00002fa0| 64 20 74 6f 20 62 65 20 | 63 6f 6d 6d 61 6e 64 20 |d to be |command |
|00002fb0| 6c 69 6e 65 73 2e 20 50 | 6f 73 73 69 62 6c 65 20 |lines. P|ossible |
|00002fc0| 63 6f 6d 6d 61 6e 64 73 | 20 61 72 65 3a 0a 40 74 |commands| are:.@t|
|00002fd0| 61 62 6c 65 20 40 63 6f | 64 65 0a 40 69 74 65 6d |able @co|de.@item|
|00002fe0| 20 23 6c 61 6e 67 75 61 | 67 65 20 3c 73 74 72 3e | #langua|ge <str>|
|00002ff0| 0a 67 69 76 65 73 20 74 | 68 65 20 70 72 6f 67 72 |.gives t|he progr|
|00003000| 61 6d 73 20 64 65 66 61 | 75 6c 74 20 6c 61 6e 67 |ams defa|ult lang|
|00003010| 75 61 67 65 2c 20 74 68 | 65 20 6c 61 6e 67 75 61 |uage, th|e langua|
|00003020| 67 65 20 6f 66 20 74 68 | 65 20 73 74 72 69 6e 67 |ge of th|e string|
|00003030| 73 20 69 6e 20 74 68 65 | 0a 63 61 74 61 6c 6f 67 |s in the|.catalog|
|00003040| 20 64 65 73 63 72 69 70 | 74 69 6f 6e 2e 20 44 65 | descrip|tion. De|
|00003050| 66 61 75 6c 74 20 69 73 | 20 40 73 61 6d 70 7b 23 |fault is| @samp{#|
|00003060| 6c 61 6e 67 75 61 67 65 | 20 65 6e 67 6c 69 73 68 |language| english|
|00003070| 7d 2e 0a 40 69 74 65 6d | 20 23 76 65 72 73 69 6f |}..@item| #versio|
|00003080| 6e 20 3c 6e 75 6d 3e 0a | 67 69 76 65 73 20 74 68 |n <num>.|gives th|
|00003090| 65 20 76 65 72 73 69 6f | 6e 20 6e 75 6d 62 65 72 |e versio|n number|
|000030a0| 20 6f 66 20 63 61 74 61 | 6c 6f 67 73 20 74 6f 20 | of cata|logs to |
|000030b0| 62 65 20 6f 70 65 6e 65 | 64 2e 20 4e 6f 74 65 20 |be opene|d. Note |
|000030c0| 74 68 61 74 20 74 68 69 | 73 20 6e 75 6d 62 65 72 |that thi|s number|
|000030d0| 0a 6d 75 73 74 20 62 65 | 20 65 78 61 63 74 20 61 |.must be| exact a|
|000030e0| 6e 64 20 6e 6f 74 20 73 | 61 6d 65 20 6f 72 20 68 |nd not s|ame or h|
|000030f0| 69 67 68 65 72 20 61 73 | 20 69 6e 20 40 63 69 74 |igher as| in @cit|
|00003100| 65 7b 45 78 65 63 2e 4f | 70 65 6e 4c 69 62 72 61 |e{Exec.O|penLibra|
|00003110| 72 79 7d 2e 0a 41 6e 20 | 65 78 63 65 70 74 69 6f |ry}..An |exceptio|
|00003120| 6e 20 69 73 20 74 68 65 | 20 6e 75 6d 62 65 72 20 |n is the| number |
|00003130| 30 2c 20 77 68 69 63 68 | 20 61 63 63 65 70 74 73 |0, which| accepts|
|00003140| 20 61 6e 79 20 63 61 74 | 61 6c 6f 67 2e 20 44 65 | any cat|alog. De|
|00003150| 66 61 75 6c 74 20 69 73 | 0a 40 73 61 6d 70 7b 23 |fault is|.@samp{#|
|00003160| 76 65 72 73 69 6f 6e 20 | 30 7d 2e 20 53 65 65 20 |version |0}. See |
|00003170| 40 63 6f 64 65 7b 4c 6f | 63 61 6c 65 2e 4f 70 65 |@code{Lo|cale.Ope|
|00003180| 6e 43 61 74 61 6c 6f 67 | 7d 20 66 6f 72 20 66 75 |nCatalog|} for fu|
|00003190| 72 74 68 65 72 20 69 6e | 66 6f 72 6d 61 74 69 6f |rther in|formatio|
|000031a0| 6e 0a 6f 6e 20 63 61 74 | 61 6c 6f 67 20 6c 61 6e |n.on cat|alog lan|
|000031b0| 67 75 61 67 65 20 61 6e | 64 20 76 65 72 73 69 6f |guage an|d versio|
|000031c0| 6e 2e 0a 40 69 74 65 6d | 20 23 6c 65 6e 67 74 68 |n..@item| #length|
|000031d0| 62 79 74 65 73 20 3c 6e | 75 6d 3e 0a 49 6e 73 74 |bytes <n|um>.Inst|
|000031e0| 72 75 63 74 73 20 46 6c | 65 78 43 61 74 20 74 6f |ructs Fl|exCat to|
|000031f0| 20 70 75 74 20 74 68 65 | 20 67 69 76 65 6e 20 6e | put the| given n|
|00003200| 75 6d 62 65 72 20 6f 66 | 20 62 79 74 65 73 20 62 |umber of| bytes b|
|00003210| 65 66 6f 72 65 20 61 20 | 73 74 72 69 6e 67 20 63 |efore a |string c|
|00003220| 6f 6e 74 61 69 6e 69 6e | 67 0a 69 74 73 20 6c 65 |ontainin|g.its le|
|00003230| 6e 67 74 68 2e 20 54 68 | 65 20 6c 65 6e 67 74 68 |ngth. Th|e length|
|00003240| 20 69 73 20 74 68 65 20 | 6e 75 6d 62 65 72 20 6f | is the |number o|
|00003250| 66 20 62 79 74 65 73 20 | 69 6e 20 74 68 65 20 73 |f bytes |in the s|
|00003260| 74 72 69 6e 67 20 77 69 | 74 68 6f 75 74 20 6c 65 |tring wi|thout le|
|00003270| 6e 67 74 68 0a 62 79 74 | 65 73 20 61 6e 64 20 61 |ngth.byt|es and a|
|00003280| 20 74 72 61 69 6c 69 6e | 67 20 40 73 61 6d 70 7b | trailin|g @samp{|
|00003290| 4e 55 4c 7d 20 62 79 74 | 65 2e 20 28 43 61 74 61 |NUL} byt|e. (Cata|
|000032a0| 6c 6f 67 20 66 69 6c 65 | 73 20 61 6e 64 20 68 65 |log file|s and he|
|000032b0| 6e 63 65 20 63 61 74 61 | 6c 6f 67 0a 73 74 72 69 |nce cata|log.stri|
|000032c0| 6e 67 73 20 77 69 6c 6c | 20 68 61 76 65 20 61 20 |ngs will| have a |
|000032d0| 74 72 61 69 6c 69 6e 67 | 20 40 73 61 6d 70 7b 4e |trailing| @samp{N|
|000032e0| 55 4c 7d 20 62 79 74 65 | 2e 20 54 68 69 73 20 69 |UL} byte|. This i|
|000032f0| 73 20 6e 6f 74 20 61 6c | 77 61 79 73 20 74 72 75 |s not al|ways tru|
|00003300| 65 20 66 6f 72 0a 74 68 | 65 20 64 65 66 61 75 6c |e for.th|e defaul|
|00003310| 74 20 73 74 72 69 6e 67 | 73 2c 20 64 65 70 65 6e |t string|s, depen|
|00003320| 64 69 6e 67 20 6f 6e 20 | 74 68 65 20 73 6f 75 72 |ding on |the sour|
|00003330| 63 65 20 64 65 73 63 72 | 69 70 74 69 6f 6e 20 66 |ce descr|iption f|
|00003340| 69 6c 65 2e 29 0a 40 73 | 61 6d 70 7b 3c 6e 75 6d |ile.).@s|amp{<num|
|00003350| 3e 7d 20 6d 75 73 74 20 | 62 65 20 6c 6f 77 65 72 |>} must |be lower|
|00003360| 20 6f 72 20 65 71 75 61 | 6c 20 73 69 7a 65 6f 66 | or equa|l sizeof|
|00003370| 28 6c 6f 6e 67 29 2c 20 | 74 68 61 74 20 69 73 20 |(long), |that is |
|00003380| 6c 6f 77 65 72 20 6f 72 | 20 65 71 75 61 6c 0a 66 |lower or| equal.f|
|00003390| 6f 75 72 2e 20 44 65 66 | 61 75 6c 74 20 69 73 20 |our. Def|ault is |
|000033a0| 40 73 61 6d 70 7b 23 6c | 65 6e 67 74 68 62 79 74 |@samp{#l|engthbyt|
|000033b0| 65 73 20 30 7d 2e 0a 40 | 69 74 65 6d 20 23 62 61 |es 0}..@|item #ba|
|000033c0| 73 65 6e 61 6d 65 20 3c | 73 74 72 3e 0a 53 65 74 |sename <|str>.Set|
|000033d0| 73 20 74 68 65 20 62 61 | 73 65 6e 61 6d 65 20 6f |s the ba|sename o|
|000033e0| 66 20 74 68 65 20 73 6f | 75 72 63 65 20 64 65 73 |f the so|urce des|
|000033f0| 63 72 69 70 74 69 6f 6e | 2e 20 40 78 72 65 66 7b |cription|. @xref{|
|00003400| 53 6f 75 72 63 65 20 64 | 65 73 63 72 69 70 74 69 |Source d|escripti|
|00003410| 6f 6e 7d 2e 0a 54 68 69 | 73 20 6f 76 65 72 77 72 |on}..Thi|s overwr|
|00003420| 69 74 65 73 20 74 68 65 | 20 62 61 73 65 6e 61 6d |ites the| basenam|
|00003430| 65 20 66 72 6f 6d 20 74 | 68 65 20 63 6f 6d 6d 61 |e from t|he comma|
|00003440| 6e 64 20 6c 69 6e 65 20 | 61 72 67 75 6d 65 6e 74 |nd line |argument|
|00003450| 20 43 44 46 49 4c 45 2e | 0a 40 78 72 65 66 7b 50 | CDFILE.|.@xref{P|
|00003460| 72 6f 67 72 61 6d 20 73 | 74 61 72 74 7d 2e 0a 40 |rogram s|tart}..@|
|00003470| 65 6e 64 20 74 61 62 6c | 65 0a 43 6f 6d 6d 61 6e |end tabl|e.Comman|
|00003480| 64 73 20 61 72 65 20 63 | 61 73 65 20 69 6e 73 65 |ds are c|ase inse|
|00003490| 6e 73 69 74 69 76 65 2e | 0a 40 69 74 65 6d 20 44 |nsitive.|.@item D|
|000034a0| 65 73 63 72 69 70 74 69 | 6f 6e 20 6c 69 6e 65 73 |escripti|on lines|
|000034b0| 0a 64 65 63 6c 61 72 65 | 20 61 20 73 74 72 69 6e |.declare| a strin|
|000034c0| 67 2e 20 54 68 65 79 20 | 6c 6f 6f 6b 20 6c 69 6b |g. They |look lik|
|000034d0| 65 20 40 73 61 6d 70 7b | 49 44 53 54 52 20 28 69 |e @samp{|IDSTR (i|
|000034e0| 64 2f 6d 69 6e 6c 65 6e | 2f 6d 61 78 6c 65 6e 29 |d/minlen|/maxlen)|
|000034f0| 7d 20 77 68 65 72 65 0a | 40 73 61 6d 70 7b 49 44 |} where.|@samp{ID|
|00003500| 53 54 52 7d 20 69 73 20 | 61 20 69 64 65 6e 74 69 |STR} is |a identi|
|00003510| 66 69 65 72 20 28 61 20 | 73 74 72 69 6e 67 20 63 |fier (a |string c|
|00003520| 6f 6e 73 74 69 73 74 69 | 6e 67 20 6f 66 20 74 68 |onstisti|ng of th|
|00003530| 65 20 63 68 61 72 61 63 | 74 65 72 73 0a 61 2d 7a |e charac|ters.a-z|
|00003540| 2c 41 2d 5a 20 61 6e 64 | 20 30 2d 39 29 2c 20 40 |,A-Z and| 0-9), @|
|00003550| 73 61 6d 70 7b 69 64 7d | 20 69 73 20 61 20 75 6e |samp{id}| is a un|
|00003560| 69 63 20 6e 75 6d 62 65 | 72 20 28 66 72 6f 6d 20 |ic numbe|r (from |
|00003570| 6e 6f 77 20 6f 6e 20 63 | 61 6c 6c 65 64 20 61 73 |now on c|alled as|
|00003580| 20 49 44 29 2c 0a 40 73 | 61 6d 70 7b 6d 69 6e 6c | ID),.@s|amp{minl|
|00003590| 65 6e 7d 20 61 6e 64 20 | 40 73 61 6d 70 7b 6d 61 |en} and |@samp{ma|
|000035a0| 78 6c 65 6e 7d 0a 61 72 | 65 20 74 68 65 20 73 74 |xlen}.ar|e the st|
|000035b0| 72 69 6e 67 73 20 6d 69 | 6e 69 6d 75 6d 20 61 6e |rings mi|nimum an|
|000035c0| 64 20 6d 61 78 69 6d 75 | 6d 20 6c 65 6e 67 74 68 |d maximu|m length|
|000035d0| 2c 20 72 65 73 70 65 63 | 74 69 76 65 6c 79 2e 20 |, respec|tively. |
|000035e0| 54 68 65 20 6c 61 74 74 | 65 72 20 74 68 72 65 65 |The latt|er three|
|000035f0| 0a 6d 61 79 20 62 65 20 | 6d 69 73 73 69 6e 67 20 |.may be |missing |
|00003600| 28 62 75 74 20 6e 6f 74 | 20 74 68 65 20 63 68 61 |(but not| the cha|
|00003610| 72 61 63 74 65 72 73 20 | 40 73 61 6d 70 7b 28 2f |racters |@samp{(/|
|00003620| 2f 29 7d 21 29 20 69 6e | 20 77 68 69 63 68 20 63 |/)}!) in| which c|
|00003630| 61 73 65 20 46 6c 65 78 | 43 61 74 0a 63 68 6f 6f |ase Flex|Cat.choo|
|00003640| 73 65 73 20 61 20 6e 75 | 6d 62 65 72 20 61 6e 64 |ses a nu|mber and|
|00003650| 20 6d 61 6b 65 73 20 6e | 6f 20 72 65 73 74 72 69 | makes n|o restri|
|00003660| 63 74 69 6f 6e 73 20 6f | 6e 20 74 68 65 20 73 74 |ctions o|n the st|
|00003670| 72 69 6e 67 20 6c 65 6e | 67 74 68 2e 0a 42 65 74 |ring len|gth..Bet|
|00003680| 74 65 72 20 64 6f 6e 27 | 74 20 75 73 65 20 74 68 |ter don'|t use th|
|00003690| 65 20 49 44 27 73 2c 20 | 69 66 20 79 6f 75 20 64 |e ID's, |if you d|
|000036a0| 6f 6e 27 74 20 6e 65 65 | 64 2e 20 54 68 65 20 6c |on't nee|d. The l|
|000036b0| 69 6e 65 73 20 66 6f 6c | 6c 6f 77 69 6e 67 20 61 |ines fol|lowing a|
|000036c0| 72 65 20 74 68 65 0a 40 | 69 74 65 6d 20 53 74 72 |re the.@|item Str|
|000036d0| 69 6e 67 20 6c 69 6e 65 | 73 0a 40 63 69 6e 64 65 |ing line|s.@cinde|
|000036e0| 78 20 43 6f 6e 74 72 6f | 6c 20 63 68 61 72 61 63 |x Contro|l charac|
|000036f0| 74 65 72 73 0a 40 63 69 | 6e 64 65 78 20 41 73 63 |ters.@ci|ndex Asc|
|00003700| 69 69 2d 43 6f 64 65 0a | 63 6f 6e 74 61 69 6e 69 |ii-Code.|containi|
|00003710| 6e 67 20 74 68 65 20 73 | 74 72 69 6e 67 20 69 74 |ng the s|tring it|
|00003720| 73 65 6c 66 20 61 6e 64 | 20 6e 6f 74 68 69 6e 67 |self and| nothing|
|00003730| 20 65 6c 73 65 2e 20 54 | 68 65 73 65 20 6d 61 79 | else. T|hese may|
|00003740| 20 63 6f 6e 74 61 69 6e | 20 63 65 72 74 61 69 6e | contain| certain|
|00003750| 0a 63 6f 6e 74 72 6f 6c | 20 63 68 61 72 61 63 74 |.control| charact|
|00003760| 65 72 73 20 62 65 67 69 | 6e 6e 69 6e 67 20 77 69 |ers begi|nning wi|
|00003770| 74 68 20 61 20 62 61 63 | 6b 73 6c 61 73 68 3a 0a |th a bac|kslash:.|
|00003780| 40 74 61 62 6c 65 20 40 | 73 61 6d 70 0a 40 69 74 |@table @|samp.@it|
|00003790| 65 6d 20 5c 62 0a 42 61 | 63 6b 73 70 61 63 65 20 |em \b.Ba|ckspace |
|000037a0| 28 41 73 63 69 69 20 38 | 29 0a 40 69 74 65 6d 20 |(Ascii 8|).@item |
|000037b0| 5c 63 0a 43 6f 6e 74 72 | 6f 6c 20 53 65 71 75 65 |\c.Contr|ol Seque|
|000037c0| 6e 63 65 20 49 6e 74 72 | 6f 64 75 63 65 72 20 28 |nce Intr|oducer (|
|000037d0| 41 73 63 69 69 20 31 35 | 35 29 0a 40 69 74 65 6d |Ascii 15|5).@item|
|000037e0| 20 5c 65 0a 45 73 63 61 | 70 65 20 28 41 73 63 69 | \e.Esca|pe (Asci|
|000037f0| 69 20 32 37 29 0a 40 69 | 74 65 6d 20 5c 66 0a 46 |i 27).@i|tem \f.F|
|00003800| 6f 72 6d 20 46 65 65 64 | 20 28 41 73 63 69 69 20 |orm Feed| (Ascii |
|00003810| 31 32 29 0a 40 69 74 65 | 6d 20 5c 67 0a 44 69 73 |12).@ite|m \g.Dis|
|00003820| 70 6c 61 79 20 62 65 65 | 70 20 28 41 73 63 69 69 |play bee|p (Ascii|
|00003830| 20 37 29 0a 40 69 74 65 | 6d 20 5c 6e 0a 4c 69 6e | 7).@ite|m \n.Lin|
|00003840| 65 20 46 65 65 64 2c 20 | 6e 65 77 6c 69 6e 65 20 |e Feed, |newline |
|00003850| 28 41 73 63 69 69 20 31 | 30 29 0a 40 69 74 65 6d |(Ascii 1|0).@item|
|00003860| 20 5c 72 0a 43 61 72 72 | 69 61 67 65 20 52 65 74 | \r.Carr|iage Ret|
|00003870| 75 72 6e 20 28 41 73 63 | 69 69 20 31 33 29 0a 40 |urn (Asc|ii 13).@|
|00003880| 69 74 65 6d 20 5c 74 0a | 54 61 62 20 28 41 73 63 |item \t.|Tab (Asc|
|00003890| 69 69 20 39 29 0a 40 69 | 74 65 6d 20 5c 76 0a 56 |ii 9).@i|tem \v.V|
|000038a0| 65 72 74 69 63 61 6c 20 | 74 61 62 20 28 41 73 63 |ertical |tab (Asc|
|000038b0| 69 69 20 31 31 29 0a 40 | 69 74 65 6d 20 5c 29 0a |ii 11).@|item \).|
|000038c0| 54 68 65 20 74 72 61 69 | 6c 69 6e 67 20 62 72 61 |The trai|ling bra|
|000038d0| 63 6b 65 74 20 77 68 69 | 63 68 20 69 73 20 70 6f |cket whi|ch is po|
|000038e0| 73 73 69 62 6c 79 20 6e | 65 65 64 65 64 20 61 73 |ssibly n|eeded as|
|000038f0| 20 70 61 72 74 20 6f 66 | 20 61 20 40 73 61 6d 70 | part of| a @samp|
|00003900| 7b 28 2e 2e 29 7d 0a 73 | 65 71 75 65 6e 63 65 2c |{(..)}.s|equence,|
|00003910| 20 73 65 65 20 40 72 65 | 66 7b 53 6f 75 72 63 65 | see @re|f{Source|
|00003920| 20 64 65 73 63 72 69 70 | 74 69 6f 6e 7d 2e 0a 40 | descrip|tion}..@|
|00003930| 69 74 65 6d 20 5c 5c 0a | 54 68 65 20 62 61 63 6b |item \\.|The back|
|00003940| 73 6c 61 73 68 20 69 74 | 73 65 6c 66 0a 40 69 74 |slash it|self.@it|
|00003950| 65 6d 20 5c 78 48 48 0a | 54 68 65 20 63 68 61 72 |em \xHH.|The char|
|00003960| 61 63 74 65 72 20 67 69 | 76 65 6e 20 62 79 20 74 |acter gi|ven by t|
|00003970| 68 65 20 61 73 63 69 69 | 20 63 6f 64 65 20 40 73 |he ascii| code @s|
|00003980| 61 6d 70 7b 48 48 7d 2c | 20 77 68 65 72 65 20 40 |amp{HH},| where @|
|00003990| 73 61 6d 70 7b 48 48 7d | 20 61 72 65 20 68 65 78 |samp{HH}| are hex|
|000039a0| 0a 64 69 67 69 74 73 2e | 0a 40 69 74 65 6d 20 5c |.digits.|.@item \|
|000039b0| 4f 4f 4f 0a 54 68 65 20 | 63 68 61 72 61 63 74 65 |OOO.The |characte|
|000039c0| 72 20 67 69 76 65 6e 20 | 62 79 20 74 68 65 20 61 |r given |by the a|
|000039d0| 73 63 69 69 20 63 6f 64 | 65 20 40 73 61 6d 70 7b |scii cod|e @samp{|
|000039e0| 4f 4f 4f 7d 2c 20 77 68 | 65 72 65 20 40 73 61 6d |OOO}, wh|ere @sam|
|000039f0| 70 7b 4f 4f 4f 7d 20 61 | 72 65 20 6f 63 74 61 6c |p{OOO} a|re octal|
|00003a00| 0a 64 69 67 69 74 73 2e | 0a 40 65 6e 64 20 74 61 |.digits.|.@end ta|
|00003a10| 62 6c 65 0a 46 69 6e 61 | 6c 6c 79 20 61 20 73 69 |ble.Fina|lly a si|
|00003a20| 6e 67 6c 65 20 62 61 63 | 6b 73 6c 61 73 68 20 61 |ngle bac|kslash a|
|00003a30| 74 20 74 68 65 20 65 6e | 64 20 6f 66 20 74 68 65 |t the en|d of the|
|00003a40| 20 6c 69 6e 65 20 63 61 | 75 73 65 73 20 63 6f 6e | line ca|uses con|
|00003a50| 63 61 74 65 6e 69 6e 67 | 20 74 68 65 0a 66 6f 6c |catening| the.fol|
|00003a60| 6c 6f 77 69 6e 67 20 6c | 69 6e 65 2e 20 54 68 69 |lowing l|ine. Thi|
|00003a70| 73 20 6d 61 6b 65 73 20 | 69 74 20 70 6f 73 73 69 |s makes |it possi|
|00003a80| 62 6c 65 20 74 6f 20 75 | 73 65 20 73 74 72 69 6e |ble to u|se strin|
|00003a90| 67 73 20 6f 66 20 61 6e | 79 20 6c 65 6e 67 74 68 |gs of an|y length|
|00003aa0| 2c 20 46 6c 65 78 43 61 | 74 0a 6d 61 6b 65 73 20 |, FlexCa|t.makes |
|00003ab0| 6e 6f 20 61 73 73 75 6d | 70 74 69 6f 6e 73 20 6f |no assum|ptions o|
|00003ac0| 6e 20 73 74 72 69 6e 67 | 20 6c 65 6e 67 74 68 2e |n string| length.|
|00003ad0| 0a 40 65 6e 64 20 74 61 | 62 6c 65 0a 0a 41 20 73 |.@end ta|ble..A s|
|00003ae0| 74 72 69 6e 67 20 69 73 | 20 68 65 6e 63 65 20 67 |tring is| hence g|
|00003af0| 69 76 65 6e 20 62 79 20 | 61 20 64 65 73 63 72 69 |iven by |a descri|
|00003b00| 70 74 69 6f 6e 20 6c 69 | 6e 65 20 61 6e 64 20 74 |ption li|ne and t|
|00003b10| 68 65 20 66 6f 6c 6c 6f | 77 69 6e 67 20 73 74 72 |he follo|wing str|
|00003b20| 69 6e 67 20 6c 69 6e 65 | 2e 0a 4c 65 74 27 73 20 |ing line|..Let's |
|00003b30| 73 65 65 20 61 6e 20 65 | 78 61 6d 70 6c 65 3a 0a |see an e|xample:.|
|00003b40| 40 65 78 61 6d 70 6c 65 | 0a 20 20 20 20 6d 73 67 |@example|. msg|
|00003b50| 48 65 6c 6c 6f 20 28 2f | 34 2f 29 0a 20 20 20 20 |Hello (/|4/). |
|00003b60| 48 65 6c 6c 6f 2c 20 74 | 68 69 73 20 69 73 20 65 |Hello, t|his is e|
|00003b70| 6e 67 6c 69 73 68 21 5c | 6e 0a 40 65 6e 64 20 65 |nglish!\|n.@end e|
|00003b80| 78 61 6d 70 6c 65 0a 40 | 6e 6f 69 6e 64 65 6e 74 |xample.@|noindent|
|00003b90| 0a 40 63 69 6e 64 65 78 | 20 46 6c 65 78 43 61 74 |.@cindex| FlexCat|
|00003ba0| 2e 63 64 0a 54 68 65 20 | 49 44 20 69 73 20 6d 69 |.cd.The |ID is mi|
|00003bb0| 73 73 69 6e 67 20 68 65 | 72 65 2c 20 73 6f 20 46 |ssing he|re, so F|
|00003bc0| 6c 65 78 43 61 74 20 63 | 68 6f 6f 73 65 73 20 61 |lexCat c|hooses a|
|00003bd0| 20 73 75 69 74 61 62 6c | 65 20 6e 75 6d 62 65 72 | suitabl|e number|
|00003be0| 2e 20 54 68 65 20 6e 75 | 6d 62 65 72 20 34 0a 69 |. The nu|mber 4.i|
|00003bf0| 6e 73 74 72 75 63 74 73 | 20 46 6c 65 78 43 61 74 |nstructs| FlexCat|
|00003c00| 2c 20 74 68 61 74 20 74 | 68 65 20 66 6f 6c 6c 6f |, that t|he follo|
|00003c10| 77 69 6e 67 20 73 74 72 | 69 6e 67 20 6d 75 73 74 |wing str|ing must|
|00003c20| 20 6e 6f 74 20 68 61 76 | 65 20 6c 65 73 73 20 74 | not hav|e less t|
|00003c30| 68 61 6e 20 66 6f 75 72 | 0a 63 68 61 72 61 63 74 |han four|.charact|
|00003c40| 65 72 73 20 61 6e 64 20 | 69 74 20 6d 61 79 20 62 |ers and |it may b|
|00003c50| 65 20 6f 66 20 61 6e 79 | 20 6c 65 6e 67 74 68 2e |e of any| length.|
|00003c60| 20 53 65 65 20 74 68 65 | 20 66 69 6c 65 20 40 66 | See the| file @f|
|00003c70| 69 6c 65 7b 46 6c 65 78 | 43 61 74 2e 63 64 7d 20 |ile{Flex|Cat.cd} |
|00003c80| 66 6f 72 0a 61 20 66 75 | 72 74 68 65 72 20 65 78 |for.a fu|rther ex|
|00003c90| 61 6d 70 6c 65 2e 0a 0a | 0a 0a 40 6e 6f 64 65 20 |ample...|..@node |
|00003ca0| 43 61 74 61 6c 6f 67 20 | 74 72 61 6e 73 6c 61 74 |Catalog |translat|
|00003cb0| 69 6f 6e 0a 40 63 68 61 | 70 74 65 72 20 43 61 74 |ion.@cha|pter Cat|
|00003cc0| 61 6c 6f 67 20 74 72 61 | 6e 73 6c 61 74 69 6f 6e |alog tra|nslation|
|00003cd0| 20 66 69 6c 65 73 0a 40 | 63 69 6e 64 65 78 20 43 | files.@|cindex C|
|00003ce0| 61 74 61 6c 6f 67 20 74 | 72 61 6e 73 6c 61 74 69 |atalog t|ranslati|
|00003cf0| 6f 6e 0a 40 63 69 6e 64 | 65 78 20 2e 63 74 0a 43 |on.@cind|ex .ct.C|
|00003d00| 61 74 61 6c 6f 67 20 74 | 72 61 6e 73 6c 61 74 69 |atalog t|ranslati|
|00003d10| 6f 6e 20 66 69 6c 65 73 | 20 61 72 65 20 76 65 72 |on files| are ver|
|00003d20| 79 20 73 69 6d 69 6c 61 | 72 20 74 6f 20 63 61 74 |y simila|r to cat|
|00003d30| 61 6c 6f 67 20 64 65 73 | 63 72 69 70 74 69 6f 6e |alog des|cription|
|00003d40| 73 2c 20 65 78 63 65 70 | 74 0a 74 68 61 74 20 66 |s, excep|t.that f|
|00003d50| 6f 72 20 6f 74 68 65 72 | 20 63 6f 6d 6d 61 6e 64 |or other| command|
|00003d60| 73 20 61 6e 64 20 68 61 | 76 69 6e 67 20 6e 6f 20 |s and ha|ving no |
|00003d70| 69 6e 66 6f 72 6d 61 74 | 69 6f 6e 73 20 6f 6e 20 |informat|ions on |
|00003d80| 73 74 72 69 6e 67 20 49 | 44 20 61 6e 64 20 6c 65 |string I|D and le|
|00003d90| 6e 67 74 68 2e 0a 28 54 | 68 65 73 65 20 61 72 65 |ngth..(T|hese are|
|00003da0| 20 74 61 6b 65 6e 20 66 | 72 6f 6d 20 74 68 65 20 | taken f|rom the |
|00003db0| 63 61 74 61 6c 6f 67 20 | 64 65 73 63 72 69 70 74 |catalog |descript|
|00003dc0| 69 6f 6e 2e 29 20 4f 66 | 20 61 6e 79 20 73 74 72 |ion.) Of| any str|
|00003dd0| 69 6e 67 20 66 72 6f 6d | 20 74 68 65 0a 63 61 74 |ing from| the.cat|
|00003de0| 61 6c 6f 67 20 64 65 73 | 63 72 69 70 74 69 6f 6e |alog des|cription|
|00003df0| 20 6d 75 73 74 20 62 65 | 20 70 72 65 73 65 6e 74 | must be| present|
|00003e00| 20 28 48 6f 77 65 76 65 | 72 2c 20 46 6c 65 78 43 | (Howeve|r, FlexC|
|00003e10| 61 74 20 6f 6d 69 74 73 | 20 77 72 69 74 69 6e 67 |at omits| writing|
|00003e20| 0a 73 74 72 69 6e 67 73 | 20 69 6e 74 6f 20 74 68 |.strings| into th|
|00003e30| 65 20 63 61 74 61 6c 6f | 67 20 77 68 69 63 68 20 |e catalo|g which |
|00003e40| 61 72 65 20 69 64 65 6e | 74 69 63 61 6c 20 74 6f |are iden|tical to|
|00003e50| 20 74 68 65 20 64 65 66 | 61 75 6c 74 20 73 74 72 | the def|ault str|
|00003e60| 69 6e 67 2e 29 0a 61 6e | 64 20 6e 6f 20 61 64 64 |ing.).an|d no add|
|00003e70| 69 74 69 6f 6e 61 6c 20 | 69 64 65 6e 74 69 66 69 |itional |identifi|
|00003e80| 65 72 73 20 6d 61 79 20 | 6f 63 63 75 72 2e 20 54 |ers may |occur. T|
|00003e90| 68 69 73 20 69 73 20 65 | 61 73 79 20 61 73 73 75 |his is e|asy assu|
|00003ea0| 72 65 64 20 62 79 20 75 | 73 69 6e 67 0a 46 6c 65 |red by u|sing.Fle|
|00003eb0| 78 43 61 74 20 74 6f 20 | 63 72 65 61 74 65 20 6e |xCat to |create n|
|00003ec0| 65 77 20 63 61 74 61 6c | 6f 67 20 74 72 61 6e 73 |ew catal|og trans|
|00003ed0| 6c 61 74 69 6f 6e 20 66 | 69 6c 65 73 2e 20 40 78 |lation f|iles. @x|
|00003ee0| 72 65 66 7b 50 72 6f 67 | 72 61 6d 20 73 74 61 72 |ref{Prog|ram star|
|00003ef0| 74 7d 2e 0a 0a 54 68 65 | 20 63 6f 6d 6d 61 6e 64 |t}...The| command|
|00003f00| 73 20 61 6c 6c 6f 77 65 | 64 20 69 6e 20 63 61 74 |s allowe|d in cat|
|00003f10| 61 6c 6f 67 20 74 72 61 | 6e 73 6c 61 74 69 6f 6e |alog tra|nslation|
|00003f20| 73 20 61 72 65 3a 0a 40 | 74 61 62 6c 65 20 40 63 |s are:.@|table @c|
|00003f30| 6f 64 65 0a 40 69 74 65 | 6d 20 23 23 76 65 72 73 |ode.@ite|m ##vers|
|00003f40| 69 6f 6e 20 3c 73 74 72 | 3e 0a 47 69 76 65 73 20 |ion <str|>.Gives |
|00003f50| 74 68 65 20 63 61 74 61 | 6c 6f 67 20 76 65 72 73 |the cata|log vers|
|00003f60| 69 6f 6e 20 61 73 20 41 | 6d 69 67 61 44 4f 53 20 |ion as A|migaDOS |
|00003f70| 76 65 72 73 69 6f 6e 20 | 73 74 72 69 6e 67 2e 20 |version |string. |
|00003f80| 45 78 61 6d 70 6c 65 3a | 0a 40 65 78 61 6d 70 6c |Example:|.@exampl|
|00003f90| 65 0a 20 20 20 20 40 73 | 61 6d 70 7b 23 23 76 65 |e. @s|amp{##ve|
|00003fa0| 72 73 69 6f 6e 20 24 56 | 45 52 3a 20 44 65 75 74 |rsion $V|ER: Deut|
|00003fb0| 73 63 68 2e 63 74 20 38 | 2e 31 20 28 32 37 2e 30 |sch.ct 8|.1 (27.0|
|00003fc0| 39 2e 39 33 29 7d 0a 40 | 65 6e 64 20 65 78 61 6d |9.93)}.@|end exam|
|00003fd0| 70 6c 65 0a 54 68 65 20 | 76 65 72 73 69 6f 6e 20 |ple.The |version |
|00003fe0| 6e 75 6d 62 65 72 20 6f | 66 20 74 68 69 73 20 63 |number o|f this c|
|00003ff0| 61 74 61 6c 6f 67 20 69 | 73 20 38 2e 20 48 65 6e |atalog i|s 8. Hen|
|00004000| 63 65 20 74 68 65 20 63 | 61 74 61 6c 6f 67 20 64 |ce the c|atalog d|
|00004010| 65 73 63 72 69 70 74 69 | 6f 6e 73 0a 76 65 72 73 |escripti|ons.vers|
|00004020| 69 6f 6e 20 6e 75 6d 62 | 65 72 20 6d 75 73 74 20 |ion numb|er must |
|00004030| 62 65 20 30 20 6f 72 20 | 38 2e 0a 40 69 74 65 6d |be 0 or |8..@item|
|00004040| 20 23 23 6c 61 6e 67 75 | 61 67 65 20 3c 73 74 72 | ##langu|age <str|
|00004050| 3e 0a 54 68 65 20 63 61 | 74 61 6c 6f 67 73 20 6c |>.The ca|talogs l|
|00004060| 61 6e 67 75 61 67 65 2e | 20 4f 66 20 63 6f 75 72 |anguage.| Of cour|
|00004070| 73 65 20 74 68 69 73 20 | 73 68 6f 75 6c 64 20 62 |se this |should b|
|00004080| 65 20 61 6e 6f 74 68 65 | 72 20 6c 61 6e 67 75 61 |e anothe|r langua|
|00004090| 67 65 20 74 68 61 6e 20 | 74 68 65 0a 63 61 74 61 |ge than |the.cata|
|000040a0| 6c 6f 67 20 64 65 73 63 | 72 69 70 74 69 6f 6e 73 |log desc|riptions|
|000040b0| 20 6c 61 6e 67 75 61 67 | 65 2e 20 54 68 65 20 40 | languag|e. The @|
|000040c0| 73 61 6d 70 7b 23 23 6c | 61 6e 67 75 61 67 65 7d |samp{##l|anguage}|
|000040d0| 20 61 6e 64 20 40 73 61 | 6d 70 7b 23 23 76 65 72 | and @sa|mp{##ver|
|000040e0| 73 69 6f 6e 7d 0a 63 6f | 6d 6d 61 6e 64 73 20 6d |sion}.co|mmands m|
|000040f0| 75 73 74 20 62 65 20 70 | 72 65 73 65 6e 74 20 69 |ust be p|resent i|
|00004100| 6e 20 61 20 63 61 74 61 | 6c 6f 67 20 74 72 61 6e |n a cata|log tran|
|00004110| 73 6c 61 74 69 6f 6e 2e | 0a 40 69 74 65 6d 20 23 |slation.|.@item #|
|00004120| 23 63 6f 64 65 73 65 74 | 20 3c 6e 75 6d 3e 0a 43 |#codeset| <num>.C|
|00004130| 75 72 72 65 6e 74 6c 79 | 20 6e 6f 74 20 75 73 65 |urrently| not use|
|00004140| 64 2c 20 6d 75 73 74 20 | 62 65 20 30 2e 20 54 68 |d, must |be 0. Th|
|00004150| 69 73 20 69 73 20 74 68 | 65 20 64 65 66 61 75 6c |is is th|e defaul|
|00004160| 74 20 76 61 6c 75 65 2e | 0a 40 65 6e 64 20 74 61 |t value.|.@end ta|
|00004170| 62 6c 65 0a 0a 40 63 69 | 6e 64 65 78 20 44 65 75 |ble..@ci|ndex Deu|
|00004180| 74 73 63 68 2e 63 74 0a | 54 68 65 20 73 74 72 69 |tsch.ct.|The stri|
|00004190| 6e 67 20 66 72 6f 6d 20 | 61 62 6f 76 65 20 6c 6f |ng from |above lo|
|000041a0| 6f 6b 73 20 6c 69 6b 65 | 20 74 68 69 73 20 69 6e |oks like| this in|
|000041b0| 20 74 68 65 20 63 61 74 | 61 6c 6f 67 20 74 72 61 | the cat|alog tra|
|000041c0| 6e 73 6c 61 74 69 6f 6e | 3a 0a 40 65 78 61 6d 70 |nslation|:.@examp|
|000041d0| 6c 65 0a 20 20 20 20 6d | 73 67 48 65 6c 6c 6f 0a |le. m|sgHello.|
|000041e0| 20 20 20 20 48 61 6c 6c | 6f 2c 20 64 69 65 73 20 | Hall|o, dies |
|000041f0| 69 73 74 20 64 65 75 74 | 73 63 68 21 5c 6e 0a 40 |ist deut|sch!\n.@|
|00004200| 65 6e 64 20 65 78 61 6d | 70 6c 65 0a 40 6e 6f 69 |end exam|ple.@noi|
|00004210| 6e 64 65 6e 74 0a 53 65 | 65 20 40 66 69 6c 65 7b |ndent.Se|e @file{|
|00004220| 44 65 75 74 73 63 68 2e | 63 74 7d 20 61 73 20 66 |Deutsch.|ct} as f|
|00004230| 75 72 74 68 65 72 20 65 | 78 61 6d 70 6c 65 20 6f |urther e|xample o|
|00004240| 66 20 61 20 63 61 74 61 | 6c 6f 67 20 74 72 61 6e |f a cata|log tran|
|00004250| 73 6c 61 74 69 6f 6e 2e | 0a 0a 0a 0a 40 6e 6f 64 |slation.|....@nod|
|00004260| 65 20 53 6f 75 72 63 65 | 20 64 65 73 63 72 69 70 |e Source| descrip|
|00004270| 74 69 6f 6e 0a 40 63 68 | 61 70 74 65 72 20 53 6f |tion.@ch|apter So|
|00004280| 75 72 63 65 20 64 65 73 | 63 72 69 70 74 69 6f 6e |urce des|cription|
|00004290| 20 66 69 6c 65 73 0a 40 | 63 69 6e 64 65 78 20 53 | files.@|cindex S|
|000042a0| 6f 75 72 63 65 20 64 65 | 73 63 72 69 70 74 69 6f |ource de|scriptio|
|000042b0| 6e 0a 40 63 69 6e 64 65 | 78 20 2e 73 64 0a 54 68 |n.@cinde|x .sd.Th|
|000042c0| 69 73 20 69 73 20 74 68 | 65 20 73 70 65 63 69 61 |is is th|e specia|
|000042d0| 6c 20 70 61 72 74 20 6f | 66 20 46 6c 65 78 43 61 |l part o|f FlexCa|
|000042e0| 74 2e 20 55 6e 74 69 6c | 20 6e 6f 77 20 74 68 65 |t. Until| now the|
|000042f0| 72 65 20 69 73 20 6e 6f | 74 68 69 6e 67 20 74 68 |re is no|thing th|
|00004300| 61 74 0a 43 61 74 43 6f | 6d 70 2c 20 4b 69 74 43 |at.CatCo|mp, KitC|
|00004310| 61 74 20 61 6e 64 20 6f | 74 68 65 72 73 20 64 6f |at and o|thers do|
|00004320| 6e 27 74 20 6f 66 66 65 | 72 20 74 6f 6f 2e 20 54 |n't offe|r too. T|
|00004330| 68 65 20 63 72 65 61 74 | 65 64 20 73 6f 75 72 63 |he creat|ed sourc|
|00004340| 65 20 73 68 6f 75 6c 64 | 20 6d 61 6b 65 0a 69 74 |e should| make.it|
|00004350| 20 65 61 73 79 20 74 6f | 20 75 73 65 20 74 68 65 | easy to| use the|
|00004360| 20 63 61 74 61 6c 6f 67 | 73 20 77 69 74 68 6f 75 | catalog|s withou|
|00004370| 74 20 6c 6f 6f 73 69 6e | 67 20 66 6c 65 78 69 62 |t loosin|g flexib|
|00004380| 69 6c 69 74 79 2e 20 41 | 6e 79 20 70 72 6f 67 72 |ility. A|ny progr|
|00004390| 61 6d 6d 69 6e 67 0a 6c | 61 6e 67 75 61 67 65 20 |amming.l|anguage |
|000043a0| 73 68 6f 75 6c 64 20 62 | 65 20 70 6f 73 73 69 62 |should b|e possib|
|000043b0| 6c 65 20 61 6e 64 20 61 | 6e 79 20 72 65 71 75 69 |le and a|ny requi|
|000043c0| 72 65 6d 65 6e 74 73 20 | 73 68 6f 75 6c 64 20 62 |rements |should b|
|000043d0| 65 20 73 61 74 69 73 66 | 79 61 62 6c 65 2e 0a 54 |e satisf|yable..T|
|000043e0| 68 69 73 20 73 65 65 6d | 73 20 6c 69 6b 65 20 61 |his seem|s like a|
|000043f0| 20 63 61 6e 74 72 61 64 | 69 63 74 69 6f 6e 2c 20 | cantrad|iction, |
|00004400| 62 75 74 20 46 6c 65 78 | 43 61 74 27 73 20 73 6f |but Flex|Cat's so|
|00004410| 6c 75 74 69 6f 6e 20 61 | 72 65 20 74 68 65 20 73 |lution a|re the s|
|00004420| 6f 75 72 63 65 0a 64 65 | 73 63 72 69 70 74 69 6f |ource.de|scriptio|
|00004430| 6e 20 66 69 6c 65 73 20 | 63 6f 6e 74 61 69 6e 69 |n files |containi|
|00004440| 6e 67 20 61 20 74 65 6d | 70 6c 61 74 65 20 6f 66 |ng a tem|plate of|
|00004450| 20 74 68 65 20 73 6f 75 | 72 63 65 20 74 6f 20 62 | the sou|rce to b|
|00004460| 65 20 63 72 65 61 74 65 | 64 2e 20 54 68 65 73 65 |e create|d. These|
|00004470| 0a 61 72 65 20 65 64 69 | 74 61 62 6c 65 20 61 73 |.are edi|table as|
|00004480| 20 74 68 65 20 63 61 74 | 61 6c 6f 67 20 64 65 73 | the cat|alog des|
|00004490| 63 72 69 70 74 69 6f 6e | 20 61 6e 64 20 63 61 74 |cription| and cat|
|000044a0| 61 6c 6f 67 20 74 72 61 | 6e 73 6c 61 74 69 6f 6e |alog tra|nslation|
|000044b0| 20 66 69 6c 65 73 20 61 | 72 65 2c 0a 68 65 6e 63 | files a|re,.henc|
|000044c0| 65 20 46 6c 65 78 43 61 | 74 20 63 61 6e 20 63 72 |e FlexCa|t can cr|
|000044d0| 65 61 74 65 20 61 6e 79 | 20 63 6f 64 65 2e 0a 0a |eate any| code...|
|000044e0| 54 68 65 20 73 6f 75 72 | 63 65 20 64 65 73 63 72 |The sour|ce descr|
|000044f0| 69 70 74 69 6f 6e 73 20 | 61 72 65 20 73 65 61 72 |iptions |are sear|
|00004500| 63 68 65 64 20 66 6f 72 | 20 63 65 72 74 61 69 6e |ched for| certain|
|00004510| 20 73 79 6d 62 6f 6c 73 | 20 77 68 69 63 68 20 61 | symbols| which a|
|00004520| 72 65 20 72 65 70 6c 61 | 63 65 64 0a 62 79 20 63 |re repla|ced.by c|
|00004530| 65 72 74 61 69 6e 20 76 | 61 6c 75 65 73 2e 20 50 |ertain v|alues. P|
|00004540| 6f 73 73 69 62 6c 65 20 | 73 79 6d 62 6f 6c 73 20 |ossible |symbols |
|00004550| 61 72 65 20 74 68 65 20 | 62 61 63 6b 73 6c 61 73 |are the |backslas|
|00004560| 68 20 63 68 61 72 61 63 | 74 65 72 73 20 66 72 6f |h charac|ters fro|
|00004570| 6d 0a 61 62 6f 76 65 20 | 61 6e 64 20 61 64 64 69 |m.above |and addi|
|00004580| 74 69 6f 6e 61 6c 6c 79 | 20 73 65 71 75 65 6e 63 |tionally| sequenc|
|00004590| 65 73 20 62 65 67 69 6e | 6e 69 6e 67 20 77 69 74 |es begin|ning wit|
|000045a0| 68 20 61 20 40 73 61 6d | 70 7b 25 7d 2e 20 28 54 |h a @sam|p{%}. (T|
|000045b0| 68 69 73 20 69 73 20 77 | 65 6c 6c 0a 6b 6e 6f 77 |his is w|ell.know|
|000045c0| 6e 20 66 6f 72 20 43 20 | 70 72 6f 67 72 61 6d 6d |n for C |programm|
|000045d0| 65 72 73 2e 29 0a 40 74 | 61 62 6c 65 20 40 73 61 |ers.).@t|able @sa|
|000045e0| 6d 70 0a 40 69 74 65 6d | 20 25 62 0a 69 73 20 74 |mp.@item| %b.is t|
|000045f0| 68 65 20 62 61 73 65 20 | 6e 61 6d 65 20 6f 66 20 |he base |name of |
|00004600| 74 68 65 20 63 61 74 61 | 6c 6f 67 20 64 65 73 63 |the cata|log desc|
|00004610| 72 69 70 74 69 6f 6e 2e | 20 40 78 72 65 66 7b 50 |ription.| @xref{P|
|00004620| 72 6f 67 72 61 6d 20 73 | 74 61 72 74 7d 2e 0a 40 |rogram s|tart}..@|
|00004630| 69 74 65 6d 20 25 76 0a | 69 73 20 74 68 65 20 76 |item %v.|is the v|
|00004640| 65 72 73 69 6f 6e 20 6e | 75 6d 62 65 72 20 6f 66 |ersion n|umber of|
|00004650| 20 74 68 65 20 63 61 74 | 61 6c 6f 67 20 64 65 73 | the cat|alog des|
|00004660| 63 72 69 70 74 69 6f 6e | 2e 20 44 6f 6e 27 74 20 |cription|. Don't |
|00004670| 6d 69 78 20 74 68 69 73 | 20 75 70 20 77 69 74 68 |mix this| up with|
|00004680| 0a 74 68 65 20 63 61 74 | 61 6c 6f 67 20 76 65 72 |.the cat|alog ver|
|00004690| 73 69 6f 6e 20 73 74 72 | 69 6e 67 20 66 72 6f 6d |sion str|ing from|
|000046a0| 20 74 68 65 20 63 61 74 | 61 6c 6f 67 20 74 72 61 | the cat|alog tra|
|000046b0| 6e 73 6c 61 74 69 6f 6e | 2e 0a 40 69 74 65 6d 20 |nslation|..@item |
|000046c0| 25 6c 0a 69 73 20 74 68 | 65 20 63 61 74 61 6c 6f |%l.is th|e catalo|
|000046d0| 67 20 64 65 73 63 72 69 | 70 74 69 6f 6e 73 20 6c |g descri|ptions l|
|000046e0| 61 6e 67 75 61 67 65 2e | 20 50 6c 65 61 73 65 20 |anguage.| Please |
|000046f0| 6e 6f 74 65 2c 20 74 68 | 61 74 20 74 68 69 73 20 |note, th|at this |
|00004700| 69 73 20 69 6e 73 65 72 | 74 65 64 0a 61 73 20 61 |is inser|ted.as a|
|00004710| 20 73 74 72 69 6e 67 2e | 20 53 65 65 20 40 73 61 | string.| See @sa|
|00004720| 6d 70 7b 25 73 7d 20 62 | 65 6c 6f 77 2e 0a 62 65 |mp{%s} b|elow..be|
|00004730| 6c 6f 77 2e 0a 40 69 74 | 65 6d 20 25 6e 0a 69 73 |low..@it|em %n.is|
|00004740| 20 74 68 65 20 6e 75 6d | 62 65 72 20 6f 66 20 73 | the num|ber of s|
|00004750| 74 72 69 6e 67 73 20 69 | 6e 20 74 68 65 20 63 61 |trings i|n the ca|
|00004760| 74 61 6c 6f 67 20 64 65 | 73 63 72 69 70 74 69 6f |talog de|scriptio|
|00004770| 6e 2e 0a 40 69 74 65 6d | 20 25 25 0a 69 73 20 74 |n..@item| %%.is t|
|00004780| 68 65 20 63 68 61 72 61 | 63 74 65 72 20 40 73 61 |he chara|cter @sa|
|00004790| 6d 70 7b 25 7d 20 69 74 | 73 65 6c 66 2e 0a 40 65 |mp{%} it|self..@e|
|000047a0| 6e 64 20 74 61 62 6c 65 | 0a 0a 42 75 74 20 74 68 |nd table|..But th|
|000047b0| 65 20 6d 6f 73 74 20 69 | 6d 70 6f 72 74 61 6e 74 |e most i|mportant|
|000047c0| 20 74 68 69 6e 67 20 61 | 72 65 20 74 68 65 20 66 | thing a|re the f|
|000047d0| 6f 6c 6c 6f 77 69 6e 67 | 20 73 65 71 65 6e 63 65 |ollowing| seqence|
|000047e0| 73 2e 20 54 68 65 73 65 | 20 72 65 70 72 65 73 65 |s. These| represe|
|000047f0| 6e 74 0a 74 68 65 20 63 | 61 74 61 6c 6f 67 20 73 |nt.the c|atalog s|
|00004800| 74 72 69 6e 67 73 20 69 | 6e 20 64 69 66 66 65 72 |trings i|n differ|
|00004810| 65 6e 74 20 77 61 79 73 | 20 4c 69 6e 65 73 20 63 |ent ways| Lines c|
|00004820| 6f 6e 74 61 69 6e 69 6e | 67 20 6f 6e 65 20 6f 72 |ontainin|g one or|
|00004830| 20 6d 6f 72 65 20 6f 66 | 20 74 68 65 73 65 0a 73 | more of| these.s|
|00004840| 79 6d 62 6f 6c 73 20 61 | 72 65 20 72 65 70 65 61 |ymbols a|re repea|
|00004850| 74 65 64 20 66 6f 72 20 | 61 6e 79 20 53 74 72 69 |ted for |any Stri|
|00004860| 6e 67 2e 0a 0a 40 74 61 | 62 6c 65 20 40 73 61 6d |ng...@ta|ble @sam|
|00004870| 70 0a 40 69 74 65 6d 20 | 25 69 0a 69 73 20 74 68 |p.@item |%i.is th|
|00004880| 65 20 69 64 65 6e 74 69 | 66 69 65 72 20 66 72 6f |e identi|fier fro|
|00004890| 6d 20 74 68 65 20 63 61 | 74 61 6c 6f 67 20 64 65 |m the ca|talog de|
|000048a0| 73 63 72 69 70 74 69 6f | 6e 2e 0a 40 69 74 65 6d |scriptio|n..@item|
|000048b0| 20 25 64 0a 69 73 20 74 | 68 65 20 73 74 72 69 6e | %d.is t|he strin|
|000048c0| 67 73 20 49 44 2e 0a 40 | 69 74 65 6d 20 25 73 0a |gs ID..@|item %s.|
|000048d0| 69 73 20 74 68 65 20 73 | 74 72 69 6e 67 20 69 74 |is the s|tring it|
|000048e0| 73 65 6c 66 3b 20 74 68 | 69 73 20 77 69 6c 6c 20 |self; th|is will |
|000048f0| 62 65 20 69 6e 73 65 72 | 74 65 64 20 69 6e 20 61 |be inser|ted in a|
|00004900| 20 77 61 79 20 64 65 70 | 65 6e 64 69 6e 67 20 6f | way dep|ending o|
|00004910| 6e 20 74 68 65 0a 70 72 | 6f 67 72 61 6d 6d 69 6e |n the.pr|ogrammin|
|00004920| 67 20 6c 61 6e 67 75 61 | 67 65 20 61 6e 64 20 63 |g langua|ge and c|
|00004930| 61 6e 20 62 65 20 63 6f | 6e 74 72 6f 6c 6c 65 64 |an be co|ntrolled|
|00004940| 20 75 73 69 6e 67 20 74 | 68 65 20 63 6f 6d 6d 61 | using t|he comma|
|00004950| 6e 64 73 0a 40 73 61 6d | 70 7b 23 23 73 74 72 69 |nds.@sam|p{##stri|
|00004960| 6e 67 74 79 70 65 7d 20 | 61 6e 64 20 40 73 61 6d |ngtype} |and @sam|
|00004970| 70 7b 23 23 73 68 6f 72 | 74 73 74 72 69 6e 67 73 |p{##shor|tstrings|
|00004980| 7d 2e 0a 40 69 74 65 6d | 20 25 28 2e 2e 2e 29 0a |}..@item| %(...).|
|00004990| 69 6e 73 65 72 74 73 20 | 74 68 65 20 74 65 78 74 |inserts |the text|
|000049a0| 20 62 65 74 77 65 65 6e | 20 74 68 65 20 62 72 61 | between| the bra|
|000049b0| 63 6b 65 74 73 20 66 6f | 72 20 61 6e 79 20 73 74 |ckets fo|r any st|
|000049c0| 72 69 6e 67 20 65 78 63 | 65 70 74 20 74 68 65 20 |ring exc|ept the |
|000049d0| 6c 61 73 74 2e 0a 54 68 | 69 73 20 69 73 20 70 72 |last..Th|is is pr|
|000049e0| 6f 62 61 62 6c 79 20 6e | 65 65 64 65 64 20 69 6e |obably n|eeded in|
|000049f0| 20 41 72 72 61 79 73 2c | 20 69 66 20 74 68 65 20 | Arrays,| if the |
|00004a00| 61 72 72 61 79 20 65 6e | 74 72 69 65 73 20 73 68 |array en|tries sh|
|00004a10| 6f 75 6c 64 20 62 65 20 | 73 65 70 61 72 61 74 65 |ould be |separate|
|00004a20| 64 0a 62 79 20 63 6f 6d | 6d 61 73 2c 20 62 75 74 |d.by com|mas, but|
|00004a30| 20 74 68 65 20 6c 61 73 | 74 20 65 6e 74 72 79 20 | the las|t entry |
|00004a40| 6d 75 73 74 20 6e 6f 74 | 20 62 65 20 66 6f 6c 6c |must not| be foll|
|00004a50| 6f 77 65 64 20 62 79 20 | 61 20 63 6f 6d 6d 61 2e |owed by |a comma.|
|00004a60| 20 59 6f 75 20 63 61 6e | 0a 75 73 65 20 40 73 61 | You can|.use @sa|
|00004a70| 6d 70 7b 25 28 2c 29 7d | 20 69 6e 20 74 68 61 74 |mp{%(,)}| in that|
|00004a80| 20 63 61 73 65 2e 20 4e | 6f 74 65 20 74 68 61 74 | case. N|ote that|
|00004a90| 20 77 69 74 68 69 6e 20 | 74 68 65 20 62 72 61 63 | within |the brac|
|00004aa0| 6b 65 74 73 20 74 68 65 | 72 65 20 69 73 20 6e 6f |kets the|re is no|
|00004ab0| 0a 72 65 70 6c 61 63 69 | 6e 67 20 6f 66 20 40 73 |.replaci|ng of @s|
|00004ac0| 61 6d 70 7b 25 7d 20 73 | 65 71 75 65 6e 63 65 73 |amp{%} s|equences|
|00004ad0| 2e 20 42 61 63 6b 73 6c | 61 73 68 20 73 65 71 75 |. Backsl|ash sequ|
|00004ae0| 65 6e 63 65 73 2c 20 68 | 6f 77 65 76 65 72 2c 20 |ences, h|owever, |
|00004af0| 61 72 65 20 73 74 69 6c | 6c 0a 61 6c 6c 6f 77 65 |are stil|l.allowe|
|00004b00| 64 2e 0a 40 65 6e 64 20 | 74 61 62 6c 65 0a 0a 54 |d..@end |table..T|
|00004b10| 68 65 20 63 6f 6e 74 72 | 6f 6c 20 73 65 71 75 65 |he contr|ol seque|
|00004b20| 6e 63 65 73 20 40 73 61 | 6d 70 7b 25 6c 7d 20 61 |nces @sa|mp{%l} a|
|00004b30| 6e 64 20 40 73 61 6d 70 | 7b 25 73 7d 20 63 72 65 |nd @samp|{%s} cre|
|00004b40| 61 74 65 20 73 74 72 69 | 6e 67 73 2e 20 42 75 74 |ate stri|ngs. But|
|00004b50| 20 68 6f 77 20 73 74 72 | 69 6e 67 73 0a 6c 6f 6f | how str|ings.loo|
|00004b60| 6b 20 64 65 70 65 6e 64 | 73 20 6f 6e 20 74 68 65 |k depend|s on the|
|00004b70| 20 70 72 6f 67 72 61 6d | 20 6c 61 6e 67 75 61 67 | program| languag|
|00004b80| 65 2e 20 54 68 61 74 27 | 73 20 77 68 79 20 74 68 |e. That'|s why th|
|00004b90| 65 20 73 6f 75 72 63 65 | 20 64 65 73 63 72 69 70 |e source| descrip|
|00004ba0| 74 69 6f 6e 0a 61 6c 6c | 6f 77 73 20 63 6f 6d 6d |tion.all|ows comm|
|00004bb0| 61 6e 64 20 6c 69 6e 65 | 73 20 73 69 6d 69 6c 61 |and line|s simila|
|00004bc0| 72 20 74 6f 20 74 68 65 | 20 63 61 74 61 6c 6f 67 |r to the| catalog|
|00004bd0| 20 74 72 61 6e 73 6c 61 | 74 69 6f 6e 2e 20 54 68 | transla|tion. Th|
|00004be0| 65 73 65 20 6d 75 73 74 | 20 62 65 67 69 6e 0a 77 |ese must| begin.w|
|00004bf0| 69 74 68 20 74 68 65 20 | 66 69 72 73 74 20 63 68 |ith the |first ch|
|00004c00| 61 72 61 63 74 65 72 20 | 6f 66 20 74 68 65 20 6c |aracter |of the l|
|00004c10| 69 6e 65 20 61 6e 64 20 | 61 6e 79 20 63 6f 6d 6d |ine and |any comm|
|00004c20| 61 6e 64 20 6d 75 73 74 | 20 68 61 76 65 20 69 74 |and must| have it|
|00004c30| 73 20 6f 77 6e 20 6c 69 | 6e 65 2e 0a 50 6f 73 73 |s own li|ne..Poss|
|00004c40| 69 62 6c 65 20 63 6f 6d | 6d 61 6e 64 73 20 61 72 |ible com|mands ar|
|00004c50| 65 3a 0a 40 74 61 62 6c | 65 20 40 63 6f 64 65 0a |e:.@tabl|e @code.|
|00004c60| 40 69 74 65 6d 20 23 23 | 73 68 6f 72 74 73 74 72 |@item ##|shortstr|
|00004c70| 69 6e 67 73 0a 6d 61 6b | 65 73 20 6c 6f 6e 67 65 |ings.mak|es longe|
|00004c80| 72 20 73 74 72 69 6e 67 | 73 20 74 6f 20 62 65 20 |r string|s to be |
|00004c90| 73 70 6c 69 74 74 65 64 | 20 6f 6e 20 64 69 66 66 |splitted| on diff|
|00004ca0| 65 72 65 6e 74 20 6c 69 | 6e 65 73 2e 20 54 68 69 |erent li|nes. Thi|
|00004cb0| 73 20 69 73 20 70 72 6f | 62 61 62 6c 79 0a 6e 6f |s is pro|bably.no|
|00004cc0| 74 20 61 6c 77 61 79 73 | 20 70 6f 73 73 69 62 6c |t always| possibl|
|00004cd0| 65 20 6f 72 20 6e 6f 74 | 20 69 6d 70 6c 65 6d 65 |e or not| impleme|
|00004ce0| 6e 74 65 64 20 69 6e 74 | 6f 20 46 6c 65 78 43 61 |nted int|o FlexCa|
|00004cf0| 74 20 61 6e 64 20 68 65 | 6e 63 65 20 74 68 65 20 |t and he|nce the |
|00004d00| 64 65 66 61 75 6c 74 0a | 69 73 20 74 6f 20 63 72 |default.|is to cr|
|00004d10| 65 61 74 65 20 6f 6e 65 | 2c 20 70 72 6f 62 61 62 |eate one|, probab|
|00004d20| 6c 79 20 76 65 72 79 20 | 6c 6f 6e 67 20 73 74 72 |ly very |long str|
|00004d30| 69 6e 67 2e 0a 40 69 74 | 65 6d 20 23 23 73 74 72 |ing..@it|em ##str|
|00004d40| 69 6e 67 74 79 70 65 20 | 3c 74 79 70 65 3e 0a 54 |ingtype |<type>.T|
|00004d50| 65 6c 6c 73 20 46 6c 65 | 78 43 61 74 20 68 6f 77 |ells Fle|xCat how|
|00004d60| 20 73 74 72 69 6e 67 73 | 20 73 68 6f 75 6c 64 20 | strings| should |
|00004d70| 6c 6f 6f 6b 20 6c 69 6b | 65 2e 20 50 6f 73 73 69 |look lik|e. Possi|
|00004d80| 62 6c 65 20 74 79 70 65 | 73 20 61 72 65 0a 40 74 |ble type|s are.@t|
|00004d90| 61 62 6c 65 20 40 73 74 | 72 6f 6e 67 0a 40 69 74 |able @st|rong.@it|
|00004da0| 65 6d 20 4e 6f 6e 65 0a | 4e 6f 20 61 64 64 69 74 |em None.|No addit|
|00004db0| 69 6f 6e 61 6c 20 63 68 | 61 72 61 63 74 65 72 73 |ional ch|aracters|
|00004dc0| 20 61 72 65 20 63 72 65 | 61 74 65 64 2e 20 41 6e | are cre|ated. An|
|00004dd0| 20 69 6d 61 67 65 20 6f | 66 20 74 68 65 20 73 74 | image o|f the st|
|00004de0| 72 69 6e 67 20 69 73 20 | 69 6e 73 65 72 74 65 64 |ring is |inserted|
|00004df0| 0a 61 6e 64 20 6e 6f 74 | 68 69 6e 67 20 65 6c 73 |.and not|hing els|
|00004e00| 65 2e 20 4e 6f 20 6f 75 | 74 70 75 74 20 6f 66 20 |e. No ou|tput of |
|00004e10| 62 69 6e 61 72 79 20 63 | 68 61 72 61 63 74 65 72 |binary c|haracter|
|00004e20| 73 20 28 74 68 65 20 62 | 61 63 6b 73 6c 61 73 68 |s (the b|ackslash|
|00004e30| 20 73 65 71 75 65 6e 63 | 65 73 29 0a 69 73 20 70 | sequenc|es).is p|
|00004e40| 6f 73 73 69 62 6c 65 2e | 0a 40 69 74 65 6d 20 43 |ossible.|.@item C|
|00004e50| 0a 63 72 65 61 74 65 73 | 20 73 74 72 69 6e 67 73 |.creates| strings|
|00004e60| 20 61 63 63 6f 72 64 69 | 6e 67 20 74 6f 20 43 2e | accordi|ng to C.|
|00004e70| 20 54 68 65 20 73 74 72 | 69 6e 67 73 20 61 72 65 | The str|ings are|
|00004e80| 20 70 72 65 63 65 64 65 | 64 20 61 6e 64 20 66 6f | precede|d and fo|
|00004e90| 6c 6c 6f 77 65 64 20 62 | 79 0a 74 68 65 20 63 68 |llowed b|y.the ch|
|00004ea0| 61 72 61 63 74 65 72 20 | 40 73 61 6d 70 7b 22 7d |aracter |@samp{"}|
|00004eb0| 2e 20 53 74 72 69 6e 67 | 73 20 61 72 65 20 73 70 |. String|s are sp|
|00004ec0| 6c 69 74 74 65 64 20 75 | 73 69 6e 67 20 74 68 65 |litted u|sing the|
|00004ed0| 20 73 65 71 75 65 6e 63 | 65 73 0a 40 73 61 6d 70 | sequenc|es.@samp|
|00004ee0| 7b 22 5c 7d 20 61 74 20 | 74 68 65 20 65 6e 64 20 |{"\} at |the end |
|00004ef0| 6f 66 20 74 68 65 20 6c | 69 6e 65 20 61 6e 64 20 |of the l|ine and |
|00004f00| 40 73 61 6d 70 7b 22 7d | 20 61 74 20 74 68 65 20 |@samp{"}| at the |
|00004f10| 62 65 67 69 6e 6e 69 6e | 67 20 6f 66 20 74 68 65 |beginnin|g of the|
|00004f20| 0a 6e 65 77 20 6c 69 6e | 65 2e 20 28 54 68 65 20 |.new lin|e. (The |
|00004f30| 62 61 63 6b 73 6c 61 73 | 68 20 69 73 20 6e 65 65 |backslas|h is nee|
|00004f40| 64 65 64 20 69 6e 20 6d | 61 63 72 6f 73 2e 29 20 |ded in m|acros.) |
|00004f50| 42 69 6e 61 72 79 20 63 | 68 61 72 61 63 74 65 72 |Binary c|haracter|
|00004f60| 73 20 61 72 65 0a 69 6e | 73 65 72 74 65 64 20 75 |s are.in|serted u|
|00004f70| 73 69 6e 67 20 40 73 61 | 6d 70 7b 5c 4f 4f 4f 7d |sing @sa|mp{\OOO}|
|00004f80| 2e 20 40 78 72 65 66 7b | 43 7d 2e 0a 40 69 74 65 |. @xref{|C}..@ite|
|00004f90| 6d 20 4f 62 65 72 6f 6e | 0a 69 73 20 6c 69 6b 65 |m Oberon|.is like|
|00004fa0| 20 73 74 72 69 6e 67 20 | 74 79 70 65 20 43 2c 20 | string |type C, |
|00004fb0| 65 78 63 65 70 74 20 66 | 6f 72 20 74 68 65 20 74 |except f|or the t|
|00004fc0| 72 61 69 6c 69 6e 67 20 | 62 61 63 6b 73 6c 61 73 |railing |backslas|
|00004fd0| 68 20 61 74 20 74 68 65 | 20 65 6e 64 20 6f 66 20 |h at the| end of |
|00004fe0| 74 68 65 0a 6c 69 6e 65 | 2e 0a 40 69 74 65 6d 20 |the.line|..@item |
|00004ff0| 41 73 73 65 6d 62 6c 65 | 72 0a 53 74 72 69 6e 67 |Assemble|r.String|
|00005000| 73 20 61 72 65 20 63 72 | 65 61 74 65 64 20 75 73 |s are cr|eated us|
|00005010| 69 6e 67 20 40 73 61 6d | 70 7b 64 63 2e 62 7d 2e |ing @sam|p{dc.b}.|
|00005020| 20 52 65 61 64 61 62 6c | 65 20 61 73 63 69 69 20 | Readabl|e ascii |
|00005030| 63 68 61 72 61 63 74 65 | 72 73 20 61 72 65 20 70 |characte|rs are p|
|00005040| 72 65 63 65 64 65 64 0a | 61 6e 64 20 66 6f 6c 6c |receded.|and foll|
|00005050| 6f 77 65 64 20 62 79 20 | 74 68 65 20 63 68 61 72 |owed by |the char|
|00005060| 61 63 74 65 72 20 40 73 | 61 6d 70 7b 27 7d 2c 20 |acter @s|amp{'}, |
|00005070| 62 69 6e 61 72 79 20 63 | 68 61 72 61 63 74 65 72 |binary c|haracter|
|00005080| 73 20 61 72 65 20 69 6e | 73 65 72 74 65 64 20 61 |s are in|serted a|
|00005090| 73 0a 40 73 61 6d 70 7b | 24 58 58 7d 2e 20 40 78 |s.@samp{|$XX}. @x|
|000050a0| 72 65 66 7b 41 73 73 65 | 6d 62 6c 65 72 7d 2e 0a |ref{Asse|mbler}..|
|000050b0| 40 65 6e 64 20 74 61 62 | 6c 65 0a 40 65 6e 64 20 |@end tab|le.@end |
|000050c0| 74 61 62 6c 65 0a 0a 4c | 65 74 27 73 20 6c 6f 6f |table..L|et's loo|
|000050d0| 6b 20 61 74 20 61 6e 20 | 65 78 63 65 72 70 74 20 |k at an |excerpt |
|000050e0| 66 72 6f 6d 20 74 68 65 | 20 66 69 6c 65 20 40 66 |from the| file @f|
|000050f0| 69 6c 65 7b 43 5f 68 2e | 73 64 7d 20 63 72 65 61 |ile{C_h.|sd} crea|
|00005100| 74 69 6e 67 20 61 6e 20 | 69 6e 63 6c 75 64 65 0a |ting an |include.|
|00005110| 66 69 6c 65 20 66 6f 72 | 20 74 68 65 20 70 72 6f |file for| the pro|
|00005120| 67 72 61 6d 6d 69 6e 67 | 20 6c 61 6e 67 75 61 67 |gramming| languag|
|00005130| 65 20 43 2e 0a 40 65 78 | 61 6d 70 6c 65 0a 23 23 |e C..@ex|ample.##|
|00005140| 73 74 72 69 6e 67 74 79 | 70 65 20 43 0a 23 23 73 |stringty|pe C.##s|
|00005150| 68 6f 72 74 73 74 72 69 | 6e 67 73 0a 0a 23 69 66 |hortstri|ngs..#if|
|00005160| 6e 64 65 66 20 25 62 5f | 43 41 54 5f 48 20 20 20 |ndef %b_|CAT_H |
|00005170| 20 2f 2a 09 41 73 73 75 | 72 65 20 74 68 61 74 20 | /*.Assu|re that |
|00005180| 74 68 69 73 20 69 73 20 | 72 65 61 64 20 6f 6e 6c |this is |read onl|
|00005190| 79 20 6f 6e 63 65 2e 20 | 2a 2f 0a 23 64 65 66 69 |y once. |*/.#defi|
|000051a0| 6e 65 20 25 62 5f 43 41 | 54 5f 48 0a 0a 0a 2f 2a |ne %b_CA|T_H.../*|
|000051b0| 20 20 47 65 74 20 6f 74 | 68 65 72 20 69 6e 63 6c | Get ot|her incl|
|000051c0| 75 64 65 20 66 69 6c 65 | 73 09 2a 2f 0a 23 69 6e |ude file|s.*/.#in|
|000051d0| 63 6c 75 64 65 20 3c 65 | 78 65 63 2f 74 79 70 65 |clude <e|xec/type|
|000051e0| 73 2e 68 3e 0a 23 69 6e | 63 6c 75 64 65 20 3c 6c |s.h>.#in|clude <l|
|000051f0| 69 62 72 61 72 69 65 73 | 2f 6c 6f 63 61 6c 65 2e |ibraries|/locale.|
|00005200| 68 3e 0a 0a 0a 2f 2a 20 | 20 50 72 6f 74 6f 74 79 |h>.../* | Prototy|
|00005210| 70 65 73 09 2a 2f 0a 65 | 78 74 65 72 6e 20 76 6f |pes.*/.e|xtern vo|
|00005220| 69 64 20 4f 70 65 6e 25 | 62 43 61 74 61 6c 6f 67 |id Open%|bCatalog|
|00005230| 28 73 74 72 75 63 74 20 | 4c 6f 63 61 6c 65 20 2a |(struct |Locale *|
|00005240| 2c 20 53 54 52 50 54 52 | 29 3b 0a 65 78 74 65 72 |, STRPTR|);.exter|
|00005250| 6e 20 76 6f 69 64 20 43 | 6c 6f 73 65 25 62 43 61 |n void C|lose%bCa|
|00005260| 74 61 6c 6f 67 28 76 6f | 69 64 29 3b 0a 65 78 74 |talog(vo|id);.ext|
|00005270| 65 72 6e 20 53 54 52 50 | 54 52 20 47 65 74 25 62 |ern STRP|TR Get%b|
|00005280| 53 74 72 69 6e 67 28 4c | 4f 4e 47 29 3b 0a 0a 2f |String(L|ONG);../|
|00005290| 2a 20 20 44 65 66 69 6e | 69 74 69 6f 6e 73 20 6f |* Defin|itions o|
|000052a0| 66 20 74 68 65 20 69 64 | 65 6e 74 69 66 69 65 72 |f the id|entifier|
|000052b0| 73 20 61 6e 64 20 74 68 | 65 69 72 20 49 44 27 73 |s and th|eir ID's|
|000052c0| 20 20 20 20 20 20 20 20 | 20 20 20 2a 2f 0a 2f 2a | | */./*|
|000052d0| 20 20 54 68 69 73 20 6c | 69 6e 65 20 77 69 6c 6c | This l|ine will|
|000052e0| 20 62 65 20 72 65 70 65 | 61 74 65 64 20 66 6f 72 | be repe|ated for|
|000052f0| 20 61 6e 79 20 73 74 72 | 69 6e 67 2e 09 09 20 20 | any str|ing... |
|00005300| 20 20 2a 2f 0a 23 64 65 | 66 69 6e 65 20 25 69 20 | */.#de|fine %i |
|00005310| 25 64 0a 0a 23 65 6e 64 | 69 66 0a 40 65 6e 64 20 |%d..#end|if.@end |
|00005320| 65 78 61 6d 70 6c 65 0a | 0a 0a 0a 0a 40 6e 6f 64 |example.|....@nod|
|00005330| 65 20 55 73 69 6e 67 20 | 46 6c 65 78 43 61 74 20 |e Using |FlexCat |
|00005340| 73 6f 75 72 63 65 0a 40 | 63 68 61 70 74 65 72 20 |source.@|chapter |
|00005350| 49 6e 63 6c 75 64 69 6e | 67 20 46 6c 65 78 43 61 |Includin|g FlexCa|
|00005360| 74 20 73 6f 75 72 63 65 | 20 69 6e 20 6f 77 6e 20 |t source| in own |
|00005370| 70 72 6f 67 72 61 6d 73 | 0a 40 63 69 6e 64 65 78 |programs|.@cindex|
|00005380| 20 55 73 69 6e 67 20 46 | 6c 65 78 43 61 74 20 73 | Using F|lexCat s|
|00005390| 6f 75 72 63 65 0a 40 63 | 69 6e 64 65 78 20 46 6c |ource.@c|index Fl|
|000053a0| 65 78 43 61 74 20 73 6f | 75 72 63 65 0a 4f 66 20 |exCat so|urce.Of |
|000053b0| 63 6f 75 72 73 65 20 74 | 68 69 73 20 64 65 70 65 |course t|his depe|
|000053c0| 6e 64 73 20 6f 6e 20 68 | 6f 77 20 74 68 65 20 73 |nds on h|ow the s|
|000053d0| 6f 75 72 63 65 20 69 73 | 20 63 72 65 61 74 65 64 |ource is| created|
|000053e0| 20 61 6e 64 20 68 65 6e | 63 65 20 6f 6e 20 74 68 | and hen|ce on th|
|000053f0| 65 0a 73 6f 75 72 63 65 | 20 64 65 73 63 72 69 70 |e.source| descrip|
|00005400| 74 69 6f 6e 2e 20 57 68 | 61 74 20 77 65 20 61 72 |tion. Wh|at we ar|
|00005410| 65 20 74 61 6c 6b 69 6e | 67 20 68 65 72 65 20 61 |e talkin|g here a|
|00005420| 62 6f 75 74 20 61 72 65 | 20 74 68 65 20 73 6f 75 |bout are| the sou|
|00005430| 72 63 65 20 64 65 73 63 | 72 69 70 74 69 6f 6e 0a |rce desc|ription.|
|00005440| 66 69 6c 65 73 20 64 69 | 73 74 72 69 62 75 74 65 |files di|stribute|
|00005450| 64 20 77 69 74 68 20 46 | 6c 65 78 43 61 74 2e 20 |d with F|lexCat. |
|00005460| 40 78 72 65 66 7b 53 6f | 75 72 63 65 20 64 65 73 |@xref{So|urce des|
|00005470| 63 72 69 70 74 69 6f 6e | 7d 2e 0a 0a 41 6c 6c 20 |cription|}...All |
|00005480| 73 6f 75 72 63 65 20 64 | 65 73 63 72 69 70 74 69 |source d|escripti|
|00005490| 6f 6e 73 20 73 68 6f 75 | 6c 64 20 61 6c 6c 6f 77 |ons shou|ld allow|
|000054a0| 20 75 73 69 6e 67 20 74 | 68 65 20 70 72 6f 67 72 | using t|he progr|
|000054b0| 61 6d 20 77 69 74 68 6f | 75 74 0a 40 63 6f 64 65 |am witho|ut.@code|
|000054c0| 7b 6c 6f 63 61 6c 65 2e | 6c 69 62 72 61 72 79 7d |{locale.|library}|
|000054d0| 2e 20 48 6f 77 65 76 65 | 72 2c 20 61 20 67 6c 6f |. Howeve|r, a glo|
|000054e0| 62 61 6c 65 20 76 61 72 | 69 61 62 6c 65 20 63 61 |bale var|iable ca|
|000054f0| 6c 6c 65 64 20 40 73 61 | 6d 70 7b 4c 6f 63 61 6c |lled @sa|mp{Local|
|00005500| 65 42 61 73 65 7d 0a 28 | 40 73 61 6d 70 7b 5f 4c |eBase}.(|@samp{_L|
|00005510| 6f 63 61 6c 65 42 61 73 | 65 7d 20 66 6f 72 20 61 |ocaleBas|e} for a|
|00005520| 73 73 65 6d 62 6c 65 72 | 29 20 6d 75 73 74 20 62 |ssembler|) must b|
|00005530| 65 20 70 72 65 73 65 6e | 74 20 61 6e 64 20 69 6e |e presen|t and in|
|00005540| 69 6e 69 74 69 61 6c 69 | 7a 65 64 20 77 69 74 68 |initiali|zed with|
|00005550| 0a 4e 55 4c 4c 20 6f 72 | 20 62 79 20 61 20 63 61 |.NULL or| by a ca|
|00005560| 6c 6c 20 74 6f 20 40 63 | 69 74 65 7b 45 78 65 63 |ll to @c|ite{Exec|
|00005570| 2e 4f 70 65 6e 4c 69 62 | 72 61 72 79 7d 2e 20 4e |.OpenLib|rary}. N|
|00005580| 6f 20 6c 6f 63 61 6c 69 | 7a 69 6e 67 20 69 73 20 |o locali|zing is |
|00005590| 70 6f 73 73 69 62 6c 65 | 20 69 6e 0a 74 68 65 20 |possible| in.the |
|000055a0| 66 6f 72 6d 65 72 20 63 | 61 73 65 20 65 78 63 65 |former c|ase exce|
|000055b0| 70 74 20 77 68 65 6e 20 | 75 73 69 6e 67 20 74 68 |pt when |using th|
|000055c0| 65 20 73 6f 75 72 63 65 | 20 64 65 73 63 72 69 70 |e source| descrip|
|000055d0| 74 69 6f 6e 20 40 66 69 | 6c 65 7b 43 5f 63 5f 56 |tion @fi|le{C_c_V|
|000055e0| 32 30 2e 73 64 7d 2e 0a | 54 68 69 73 20 61 6c 6c |20.sd}..|This all|
|000055f0| 6f 77 73 20 6c 6f 63 61 | 6c 69 7a 69 6e 67 20 6f |ows loca|lizing o|
|00005600| 6e 20 32 2e 30 20 62 79 | 20 72 65 70 61 63 69 6e |n 2.0 by| repacin|
|00005610| 67 20 74 68 65 20 40 63 | 6f 64 65 7b 6c 6f 63 61 |g the @c|ode{loca|
|00005620| 6c 65 2e 6c 69 62 72 61 | 72 79 7d 20 77 69 74 68 |le.libra|ry} with|
|00005630| 20 74 68 65 0a 40 63 6f | 64 65 7b 69 66 66 70 61 | the.@co|de{iffpa|
|00005640| 72 73 65 2e 6c 69 62 72 | 61 72 79 7d 2e 20 28 41 |rse.libr|ary}. (A|
|00005650| 20 76 61 72 69 61 62 6c | 65 20 40 73 61 6d 70 7b | variabl|e @samp{|
|00005660| 49 46 46 50 61 72 73 65 | 42 61 73 65 7d 20 68 61 |IFFParse|Base} ha|
|00005670| 73 20 74 6f 20 62 65 20 | 70 72 65 73 65 6e 74 0a |s to be |present.|
|00005680| 66 6f 72 20 74 68 69 73 | 20 61 6e 64 20 69 6e 69 |for this| and ini|
|00005690| 74 69 61 6c 69 7a 65 64 | 20 40 73 61 6d 70 7b 4c |tialized| @samp{L|
|000056a0| 6f 63 61 6c 65 42 61 73 | 65 7d 2e 29 20 40 78 72 |ocaleBas|e}.) @xr|
|000056b0| 65 66 7b 43 7d 2e 0a 54 | 68 65 20 70 72 6f 67 72 |ef{C}..T|he progr|
|000056c0| 61 6d 6d 65 72 20 64 6f | 65 73 20 6e 6f 74 20 6e |ammer do|es not n|
|000056d0| 65 65 64 20 6b 6e 6f 77 | 6c 65 64 67 65 20 6f 66 |eed know|ledge of|
|000056e0| 20 74 68 65 73 65 20 6c | 69 62 72 61 72 69 65 73 | these l|ibraries|
|000056f0| 20 65 78 63 65 70 74 20 | 77 68 65 6e 0a 63 72 65 | except |when.cre|
|00005700| 61 74 69 6e 67 20 6f 77 | 6e 20 73 6f 75 72 63 65 |ating ow|n source|
|00005710| 20 64 65 73 63 72 69 70 | 74 69 6f 6e 73 2e 0a 0a | descrip|tions...|
|00005720| 54 68 65 72 65 20 61 72 | 65 20 74 68 72 65 65 20 |There ar|e three |
|00005730| 66 75 6e 63 74 69 6f 6e | 73 20 61 6e 64 20 63 61 |function|s and ca|
|00005740| 6c 6c 69 6e 67 20 74 68 | 65 6d 20 69 73 20 72 61 |lling th|em is ra|
|00005750| 74 68 65 72 20 73 69 6d | 70 6c 65 2e 0a 40 64 65 |ther sim|ple..@de|
|00005760| 66 66 6e 20 7b 7d 20 4f | 70 65 6e 43 61 74 61 6c |ffn {} O|penCatal|
|00005770| 6f 67 20 28 6c 6f 63 61 | 6c 65 2c 20 6c 61 6e 67 |og (loca|le, lang|
|00005780| 75 61 67 65 29 0a 54 68 | 69 73 20 66 75 6e 63 74 |uage).Th|is funct|
|00005790| 69 6f 6e 20 70 6f 73 73 | 69 62 6c 79 20 6f 70 65 |ion poss|ibly ope|
|000057a0| 6e 73 20 61 20 63 61 74 | 61 6c 6f 67 2e 20 54 68 |ns a cat|alog. Th|
|000057b0| 65 20 61 72 67 75 6d 65 | 6e 74 20 40 63 6f 64 65 |e argume|nt @code|
|000057c0| 7b 6c 6f 63 61 6c 65 7d | 20 69 73 20 61 0a 70 6f |{locale}| is a.po|
|000057d0| 69 6e 74 65 72 20 74 6f | 20 61 20 4c 6f 63 61 6c |inter to| a Local|
|000057e0| 65 20 73 74 72 75 63 74 | 75 72 65 20 61 6d 64 20 |e struct|ure amd |
|000057f0| 40 63 6f 64 65 7b 6c 61 | 6e 67 75 61 67 65 7d 20 |@code{la|nguage} |
|00005800| 69 73 20 61 20 73 74 72 | 69 6e 67 20 63 6f 6e 74 |is a str|ing cont|
|00005810| 61 69 6e 69 6e 67 0a 74 | 68 65 20 6e 61 6d 65 20 |aining.t|he name |
|00005820| 6f 66 20 74 68 65 20 6c | 61 6e 67 75 61 67 65 20 |of the l|anguage |
|00005830| 74 68 61 74 20 73 68 6f | 75 6c 64 20 62 65 20 6f |that sho|uld be o|
|00005840| 70 65 6e 65 64 2e 20 49 | 6e 20 6d 6f 73 74 20 63 |pened. I|n most c|
|00005850| 61 73 65 73 20 74 68 65 | 73 65 20 73 68 6f 75 6c |ases the|se shoul|
|00005860| 64 0a 62 6f 74 68 20 62 | 65 20 40 73 61 6d 70 7b |d.both b|e @samp{|
|00005870| 4e 55 4c 4c 7d 20 6f 72 | 20 40 73 61 6d 70 7b 4e |NULL} or| @samp{N|
|00005880| 49 4c 7d 2c 20 72 65 73 | 70 65 63 74 69 76 65 6c |IL}, res|pectivel|
|00005890| 79 2c 20 62 65 63 61 75 | 73 65 20 74 68 65 20 75 |y, becau|se the u|
|000058a0| 73 65 72 27 73 20 64 65 | 66 61 75 6c 74 73 0a 61 |ser's de|faults.a|
|000058b0| 72 65 20 6f 76 65 72 77 | 72 69 74 74 65 6e 20 6f |re overw|ritten o|
|000058c0| 74 68 65 72 77 69 73 65 | 2e 20 53 65 65 20 40 63 |therwise|. See @c|
|000058d0| 69 74 65 7b 4c 6f 63 61 | 6c 65 2e 4f 70 65 6e 43 |ite{Loca|le.OpenC|
|000058e0| 61 74 61 6c 6f 67 7d 20 | 66 6f 72 20 64 65 74 61 |atalog} |for deta|
|000058f0| 69 6c 73 2e 0a 0a 49 66 | 20 74 68 65 20 75 73 65 |ils...If| the use|
|00005900| 72 20 68 61 73 20 40 73 | 61 6d 70 7b 44 65 75 74 |r has @s|amp{Deut|
|00005910| 73 63 68 7d 20 61 6e 64 | 20 40 73 61 6d 70 7b 46 |sch} and| @samp{F|
|00005920| 72 61 6e 63 61 69 73 7d | 20 61 73 20 64 65 66 61 |rancais}| as defa|
|00005930| 75 6c 74 20 6c 61 6e 67 | 75 61 67 65 73 0a 61 6e |ult lang|uages.an|
|00005940| 64 20 74 68 65 20 70 72 | 6f 67 72 61 6d 73 20 62 |d the pr|ograms b|
|00005950| 61 73 65 20 6e 61 6d 65 | 20 69 73 20 40 73 61 6d |ase name| is @sam|
|00005960| 70 7b 58 58 58 7d 20 74 | 68 69 73 20 6c 6f 6f 6b |p{XXX} t|his look|
|00005970| 73 20 66 6f 72 20 74 68 | 65 20 66 6f 6c 6c 6f 77 |s for th|e follow|
|00005980| 69 6e 67 20 66 69 6c 65 | 73 3a 0a 40 65 78 61 6d |ing file|s:.@exam|
|00005990| 70 6c 65 0a 20 20 20 20 | 40 66 69 6c 65 7b 50 52 |ple. |@file{PR|
|000059a0| 4f 47 44 49 52 3a 43 61 | 74 61 6c 6f 67 73 2f 44 |OGDIR:Ca|talogs/D|
|000059b0| 65 75 74 73 63 68 2f 58 | 58 58 2e 63 61 74 61 6c |eutsch/X|XX.catal|
|000059c0| 6f 67 7d 0a 20 20 20 20 | 40 66 69 6c 65 7b 4c 4f |og}. |@file{LO|
|000059d0| 43 41 4c 45 3a 43 61 74 | 61 6c 6f 67 73 2f 44 65 |CALE:Cat|alogs/De|
|000059e0| 75 74 73 63 68 2f 58 58 | 58 2e 63 61 74 61 6c 6f |utsch/XX|X.catalo|
|000059f0| 67 7d 0a 20 20 20 20 40 | 66 69 6c 65 7b 50 52 4f |g}. @|file{PRO|
|00005a00| 47 44 49 52 3a 43 61 74 | 61 6c 6f 67 73 2f 46 72 |GDIR:Cat|alogs/Fr|
|00005a10| 61 6e 63 61 69 73 2f 58 | 58 58 2e 63 61 74 61 6c |ancais/X|XX.catal|
|00005a20| 6f 67 7d 0a 20 20 20 20 | 40 66 69 6c 65 7b 4c 4f |og}. |@file{LO|
|00005a30| 43 41 4c 45 3a 43 61 74 | 61 6c 6f 67 73 2f 46 72 |CALE:Cat|alogs/Fr|
|00005a40| 61 6e 63 61 69 73 2f 58 | 58 58 2e 63 61 74 61 6c |ancais/X|XX.catal|
|00005a50| 6f 67 7d 0a 40 65 6e 64 | 20 65 78 61 6d 70 6c 65 |og}.@end| example|
|00005a60| 0a 40 6e 6f 69 6e 64 65 | 6e 74 0a 77 68 65 72 65 |.@noinde|nt.where|
|00005a70| 20 40 66 69 6c 65 7b 50 | 52 4f 47 44 49 52 3a 7d | @file{P|ROGDIR:}|
|00005a80| 20 69 73 20 74 68 65 20 | 70 72 6f 67 72 61 6d 73 | is the |programs|
|00005a90| 20 63 75 72 72 65 6e 74 | 20 64 69 72 65 63 74 6f | current| directo|
|00005aa0| 72 79 2e 20 28 54 68 65 | 20 6f 72 64 65 72 20 6f |ry. (The| order o|
|00005ab0| 66 0a 40 66 69 6c 65 7b | 50 52 4f 47 44 49 52 3a |f.@file{|PROGDIR:|
|00005ac0| 7d 20 61 6e 64 20 40 66 | 69 6c 65 7b 4c 4f 43 41 |} and @f|ile{LOCA|
|00005ad0| 4c 45 3a 7d 20 63 61 6e | 20 62 65 20 63 68 61 6e |LE:} can| be chan|
|00005ae0| 67 65 64 20 74 6f 20 73 | 75 70 70 72 65 73 73 20 |ged to s|uppress |
|00005af0| 61 20 72 65 71 75 65 73 | 74 65 72 0a 6c 69 6b 65 |a reques|ter.like|
|00005b00| 20 40 73 61 6d 70 7b 49 | 6e 73 65 72 74 20 76 6f | @samp{I|nsert vo|
|00005b10| 6c 75 6d 65 20 59 59 59 | 7d 2e 0a 0a 4f 70 65 6e |lume YYY|}...Open|
|00005b20| 43 61 74 61 6c 6f 67 20 | 69 73 20 6f 66 20 74 79 |Catalog |is of ty|
|00005b30| 70 65 20 76 6f 69 64 20 | 28 61 20 70 72 6f 63 65 |pe void |(a proce|
|00005b40| 64 75 72 65 20 66 6f 72 | 20 50 61 73 63 61 6c 20 |dure for| Pascal |
|00005b50| 70 72 6f 67 72 61 6d 6d | 65 72 73 29 20 61 6e 64 |programm|ers) and|
|00005b60| 20 68 65 6e 63 65 0a 67 | 69 76 65 73 20 6e 6f 20 | hence.g|ives no |
|00005b70| 72 65 73 75 6c 74 2e 0a | 40 65 6e 64 20 64 65 66 |result..|@end def|
|00005b80| 66 6e 0a 0a 40 64 65 66 | 66 6e 20 7b 7d 20 47 65 |fn..@def|fn {} Ge|
|00005b90| 74 53 74 72 69 6e 67 20 | 28 49 44 29 0a 47 69 76 |tString |(ID).Giv|
|00005ba0| 65 73 20 61 20 70 6f 69 | 6e 74 65 72 20 74 6f 20 |es a poi|nter to |
|00005bb0| 74 68 65 20 73 74 72 69 | 6e 67 20 77 69 74 68 20 |the stri|ng with |
|00005bc0| 74 68 65 20 67 69 76 65 | 6e 20 49 44 20 66 72 6f |the give|n ID fro|
|00005bd0| 6d 20 74 68 65 20 63 61 | 74 61 6c 6f 67 20 64 65 |m the ca|talog de|
|00005be0| 73 63 72 69 70 74 69 6f | 6e 2e 0a 4f 66 20 63 6f |scriptio|n..Of co|
|00005bf0| 75 72 73 65 20 74 68 65 | 73 65 20 73 74 72 69 6e |urse the|se strin|
|00005c00| 67 73 20 61 72 65 20 6f | 77 6e 65 64 20 62 79 20 |gs are o|wned by |
|00005c10| 40 63 6f 64 65 7b 6c 6f | 63 61 6c 65 2e 6c 69 62 |@code{lo|cale.lib|
|00005c20| 72 61 72 79 7d 20 61 6e | 64 20 6d 75 73 74 20 6e |rary} an|d must n|
|00005c30| 6f 74 20 62 65 0a 6d 6f | 64 69 66 69 65 64 2e 0a |ot be.mo|dified..|
|00005c40| 0a 41 6e 20 65 78 61 6d | 70 6c 65 20 6d 69 67 68 |.An exam|ple migh|
|00005c50| 74 20 62 65 20 75 73 65 | 66 75 6c 2e 20 54 61 6b |t be use|ful. Tak|
|00005c60| 65 20 74 68 65 20 73 74 | 72 69 6e 67 20 66 72 6f |e the st|ring fro|
|00005c70| 6d 20 74 68 65 20 63 61 | 74 61 6c 6f 67 20 64 65 |m the ca|talog de|
|00005c80| 73 63 72 69 70 74 69 6f | 6e 0a 65 78 61 6d 70 6c |scriptio|n.exampl|
|00005c90| 65 2c 20 77 68 69 63 68 | 20 77 61 73 20 63 61 6c |e, which| was cal|
|00005ca0| 6c 65 64 20 40 63 6f 64 | 65 7b 6d 73 67 48 65 6c |led @cod|e{msgHel|
|00005cb0| 6c 6f 7d 2e 20 54 68 65 | 20 73 6f 75 72 63 65 20 |lo}. The| source |
|00005cc0| 64 65 73 63 72 69 70 74 | 69 6f 6e 73 0a 64 65 63 |descript|ions.dec|
|00005cd0| 6c 61 72 65 20 61 20 63 | 6f 6e 73 74 61 6e 74 20 |lare a c|onstant |
|00005ce0| 40 73 61 6d 70 7b 6d 73 | 67 48 65 6c 6c 6f 7d 20 |@samp{ms|gHello} |
|00005cf0| 72 65 70 72 65 73 65 6e | 74 69 6e 67 20 74 68 65 |represen|ting the|
|00005d00| 20 49 44 2e 20 54 68 69 | 73 20 63 6f 75 6c 64 20 | ID. Thi|s could |
|00005d10| 62 65 0a 70 72 69 6e 74 | 65 64 20 69 6e 20 43 20 |be.print|ed in C |
|00005d20| 75 73 69 6e 67 0a 40 65 | 78 61 6d 70 6c 65 0a 20 |using.@e|xample. |
|00005d30| 20 20 20 70 72 69 6e 74 | 66 28 22 25 73 5c 6e 22 | print|f("%s\n"|
|00005d40| 2c 20 47 65 74 53 74 72 | 69 6e 67 28 6d 73 67 48 |, GetStr|ing(msgH|
|00005d50| 65 6c 6c 6f 29 29 3b 0a | 40 65 6e 64 20 65 78 61 |ello));.|@end exa|
|00005d60| 6d 70 6c 65 0a 40 65 6e | 64 20 64 65 66 66 6e 0a |mple.@en|d deffn.|
|00005d70| 0a 40 64 65 66 66 6e 20 | 7b 7d 20 43 6c 6f 73 65 |.@deffn |{} Close|
|00005d80| 43 61 74 61 6c 6f 67 20 | 28 76 6f 69 64 29 0a 54 |Catalog |(void).T|
|00005d90| 68 69 73 20 66 75 6e 63 | 74 69 6f 6e 20 66 72 65 |his func|tion fre|
|00005da0| 65 73 20 74 68 65 20 63 | 61 74 61 6c 6f 67 20 28 |es the c|atalog (|
|00005db0| 74 68 61 74 20 69 73 20 | 74 68 65 20 61 6c 6c 6f |that is |the allo|
|00005dc0| 63 61 74 65 64 20 52 41 | 4d 29 20 62 65 66 6f 72 |cated RA|M) befor|
|00005dd0| 65 0a 74 65 72 6d 69 6e | 61 74 69 6e 67 20 74 68 |e.termin|ating th|
|00005de0| 65 20 70 72 6f 67 72 61 | 6d 2e 20 59 6f 75 20 63 |e progra|m. You c|
|00005df0| 61 6e 20 63 61 6c 6c 20 | 74 68 69 73 20 66 75 6e |an call |this fun|
|00005e00| 63 74 69 6f 6e 20 61 74 | 20 61 6e 79 20 74 69 6d |ction at| any tim|
|00005e10| 65 20 65 76 65 6e 20 62 | 65 66 6f 72 65 0a 4f 70 |e even b|efore.Op|
|00005e20| 65 6e 43 61 74 61 6c 6f | 67 20 69 73 20 63 61 6c |enCatalo|g is cal|
|00005e30| 6c 65 64 2e 0a 40 65 6e | 64 20 64 65 66 66 6e 0a |led..@en|d deffn.|
|00005e40| 0a 40 6d 65 6e 75 0a 2a | 20 43 3a 3a 09 20 20 20 |.@menu.*| C::. |
|00005e50| 20 20 20 46 6c 65 78 43 | 61 74 20 73 6f 75 72 63 | FlexC|at sourc|
|00005e60| 65 20 69 6e 20 43 20 70 | 72 6f 67 72 61 6d 73 0a |e in C p|rograms.|
|00005e70| 2a 20 4f 62 65 72 6f 6e | 3a 3a 20 20 20 20 46 6c |* Oberon|:: Fl|
|00005e80| 65 78 43 61 74 20 73 6f | 75 72 63 65 20 69 6e 20 |exCat so|urce in |
|00005e90| 4f 62 65 72 6f 6e 20 70 | 72 6f 67 72 61 6d 73 0a |Oberon p|rograms.|
|00005ea0| 2a 20 41 73 73 65 6d 62 | 6c 65 72 3a 3a 20 46 6c |* Assemb|ler:: Fl|
|00005eb0| 65 78 43 61 74 20 73 6f | 75 72 63 65 20 69 6e 20 |exCat so|urce in |
|00005ec0| 41 73 73 65 6d 62 6c 65 | 72 20 70 72 6f 67 72 61 |Assemble|r progra|
|00005ed0| 6d 73 0a 40 65 6e 64 20 | 6d 65 6e 75 0a 0a 0a 0a |ms.@end |menu....|
|00005ee0| 40 6e 6f 64 65 20 43 0a | 40 73 65 63 74 69 6f 6e |@node C.|@section|
|00005ef0| 20 46 6c 65 78 43 61 74 | 20 73 6f 75 72 63 65 20 | FlexCat| source |
|00005f00| 69 6e 20 43 20 70 72 6f | 67 72 61 6d 73 0a 40 63 |in C pro|grams.@c|
|00005f10| 69 6e 64 65 78 20 43 0a | 40 63 69 6e 64 65 78 20 |index C.|@cindex |
|00005f20| 43 5f 63 5f 56 32 30 2e | 73 64 0a 40 63 69 6e 64 |C_c_V20.|sd.@cind|
|00005f30| 65 78 20 43 5f 68 2e 73 | 64 0a 40 63 69 6e 64 65 |ex C_h.s|d.@cinde|
|00005f40| 78 20 43 5f 63 5f 56 32 | 31 2e 73 64 0a 43 20 73 |x C_c_V2|1.sd.C s|
|00005f50| 6f 75 72 63 65 20 63 6f | 6e 73 69 73 74 73 20 6f |ource co|nsists o|
|00005f60| 66 20 74 77 6f 20 70 61 | 72 74 73 3a 20 41 20 40 |f two pa|rts: A @|
|00005f70| 66 69 6c 65 7b 2e 63 7d | 20 66 69 6c 65 20 77 68 |file{.c}| file wh|
|00005f80| 69 63 68 20 73 68 6f 75 | 6c 64 20 62 65 20 63 6f |ich shou|ld be co|
|00005f90| 6d 70 69 6c 65 64 0a 61 | 6e 64 20 6c 69 6e 6b 65 |mpiled.a|nd linke|
|00005fa0| 64 20 77 69 74 68 6f 75 | 74 20 66 75 72 74 68 65 |d withou|t furthe|
|00005fb0| 72 20 6e 6f 74 69 63 65 | 20 61 6e 64 20 61 6e 20 |r notice| and an |
|00005fc0| 69 6e 63 6c 75 64 65 20 | 66 69 6c 65 20 77 68 69 |include |file whi|
|00005fd0| 63 68 20 73 68 6f 75 6c | 64 20 62 65 0a 69 6e 63 |ch shoul|d be.inc|
|00005fe0| 6c 75 64 65 64 20 66 72 | 6f 6d 20 61 6e 79 20 73 |luded fr|om any s|
|00005ff0| 6f 75 72 63 65 20 70 61 | 72 74 20 75 73 69 6e 67 |ource pa|rt using|
|00006000| 20 63 61 74 61 6c 6f 67 | 20 73 74 72 69 6e 67 73 | catalog| strings|
|00006010| 20 61 6e 64 20 77 68 69 | 63 68 20 64 65 66 69 6e | and whi|ch defin|
|00006020| 65 73 20 74 68 65 0a 49 | 53 27 73 20 61 73 20 6d |es the.I|S's as m|
|00006030| 61 63 72 6f 73 20 75 73 | 69 6e 67 20 40 73 61 6d |acros us|ing @sam|
|00006040| 70 7b 23 64 65 66 69 6e | 65 7d 2e 0a 0a 54 77 6f |p{#defin|e}...Two|
|00006050| 20 64 69 66 66 65 72 65 | 6e 74 20 76 65 72 73 69 | differe|nt versi|
|00006060| 6f 6e 73 20 61 72 65 20 | 61 76 61 69 6c 61 62 6c |ons are |availabl|
|00006070| 65 20 66 6f 72 20 74 68 | 65 20 40 66 69 6c 65 7b |e for th|e @file{|
|00006080| 2e 63 7d 20 70 61 72 74 | 3a 0a 40 66 69 6c 65 7b |.c} part|:.@file{|
|00006090| 43 5f 63 5f 56 32 31 2e | 73 64 7d 20 69 73 20 61 |C_c_V21.|sd} is a|
|000060a0| 20 72 61 74 68 65 72 20 | 73 69 6d 70 6c 65 20 76 | rather |simple v|
|000060b0| 65 72 73 69 6f 6e 20 75 | 73 69 6e 67 20 74 68 65 |ersion u|sing the|
|000060c0| 20 72 65 73 70 65 63 74 | 69 76 65 20 66 75 6e 63 | respect|ive func|
|000060d0| 74 69 6f 6e 73 0a 6f 66 | 20 74 68 65 20 40 63 6f |tions.of| the @co|
|000060e0| 64 65 7b 6c 6f 63 61 6c | 65 2e 6c 69 62 72 61 72 |de{local|e.librar|
|000060f0| 79 7d 20 61 6e 64 20 61 | 6c 6c 6f 77 69 6e 67 20 |y} and a|llowing |
|00006100| 6c 6f 63 61 6c 69 7a 69 | 6e 67 20 62 65 67 69 6e |localizi|ng begin|
|00006110| 6e 69 6e 67 20 77 69 74 | 68 0a 57 6f 72 6b 62 65 |ning wit|h.Workbe|
|00006120| 6e 63 68 20 32 2e 31 2e | 20 42 75 74 20 40 66 69 |nch 2.1.| But @fi|
|00006130| 6c 65 7b 43 5f 63 5f 56 | 32 30 2e 73 64 7d 20 72 |le{C_c_V|20.sd} r|
|00006140| 65 70 6c 61 63 65 73 20 | 74 68 65 20 40 63 6f 64 |eplaces |the @cod|
|00006150| 65 7b 6c 6f 63 61 6c 65 | 2e 6c 69 62 72 61 72 79 |e{locale|.library|
|00006160| 7d 0a 77 69 74 68 20 74 | 68 65 20 40 63 6f 64 65 |}.with t|he @code|
|00006170| 7b 69 66 66 70 61 72 73 | 65 2e 6c 69 62 72 61 72 |{iffpars|e.librar|
|00006180| 79 7d 20 69 66 20 74 68 | 65 20 66 6f 72 6d 65 72 |y} if th|e former|
|00006190| 20 69 73 6e 27 74 20 61 | 76 61 69 6c 61 62 6c 65 | isn't a|vailable|
|000061a0| 20 61 6e 64 20 74 68 65 | 0a 6c 61 74 74 65 72 20 | and the|.latter |
|000061b0| 69 73 2e 20 54 68 69 73 | 20 61 6c 6c 6f 77 73 20 |is. This| allows |
|000061c0| 6c 6f 63 61 6c 69 7a 69 | 6e 67 20 66 6f 72 20 57 |localizi|ng for W|
|000061d0| 6f 72 6b 62 65 6e 63 68 | 20 32 2e 30 20 74 6f 6f |orkbench| 2.0 too|
|000061e0| 2e 20 50 72 6f 67 72 61 | 6d 73 20 75 73 69 6e 67 |. Progra|ms using|
|000061f0| 0a 74 68 69 73 20 73 68 | 6f 75 6c 64 20 68 61 76 |.this sh|ould hav|
|00006200| 65 20 61 6e 20 6f 70 74 | 69 6f 6e 20 40 63 6f 64 |e an opt|ion @cod|
|00006210| 65 7b 4c 61 6e 67 75 61 | 67 65 7d 20 61 6e 64 20 |e{Langua|ge} and |
|00006220| 67 69 76 65 20 74 68 65 | 20 63 6f 72 72 65 73 70 |give the| corresp|
|00006230| 6f 6e 64 69 6e 67 0a 61 | 72 67 75 6d 65 6e 74 20 |onding.a|rgument |
|00006240| 74 6f 20 40 73 61 6d 70 | 7b 4f 70 65 6e 43 61 74 |to @samp|{OpenCat|
|00006250| 61 6c 6f 67 7d 2e 20 54 | 68 69 73 20 6f 70 74 69 |alog}. T|his opti|
|00006260| 6f 6e 20 73 68 6f 75 6c | 64 20 6e 6f 74 20 62 65 |on shoul|d not be|
|00006270| 20 75 73 65 64 20 69 6e | 20 32 2e 31 20 61 6e 64 | used in| 2.1 and|
|00006280| 0a 61 62 6f 76 65 20 61 | 6e 64 20 68 65 6e 63 65 |.above a|nd hence|
|00006290| 20 74 68 65 20 6c 61 6e | 67 75 61 67 65 20 61 72 | the lan|guage ar|
|000062a0| 67 75 6d 65 6e 74 20 6f | 66 20 40 73 61 6d 70 7b |gument o|f @samp{|
|000062b0| 4f 70 65 6e 43 61 74 61 | 6c 6f 67 7d 20 73 68 6f |OpenCata|log} sho|
|000062c0| 75 6c 64 20 73 74 69 6c | 6c 0a 62 65 20 40 73 61 |uld stil|l.be @sa|
|000062d0| 6d 70 7b 4e 55 4c 4c 7d | 2e 0a 0a 4f 66 20 63 6f |mp{NULL}|...Of co|
|000062e0| 75 72 73 65 20 69 74 20 | 77 6f 75 6c 64 20 62 65 |urse it |would be|
|000062f0| 20 70 6f 73 73 69 62 6c | 65 20 74 6f 20 77 72 69 | possibl|e to wri|
|00006300| 74 65 20 61 20 74 68 69 | 72 64 20 76 65 72 73 69 |te a thi|rd versi|
|00006310| 6f 6e 20 75 73 69 6e 67 | 20 63 61 74 61 6c 6f 67 |on using| catalog|
|00006320| 73 0a 77 69 74 68 20 41 | 6e 73 69 69 20 43 2c 20 |s.with A|nsii C, |
|00006330| 62 75 74 20 49 20 64 6f | 6e 27 74 20 77 61 6e 74 |but I do|n't want|
|00006340| 20 74 6f 20 73 75 70 70 | 6f 72 74 20 31 2e 33 20 | to supp|ort 1.3 |
|00006350| 61 6e 79 6d 6f 72 65 2e | 0a 0a 54 6f 20 73 65 70 |anymore.|..To sep|
|00006360| 61 72 61 74 65 20 74 68 | 65 20 46 6c 65 78 43 61 |arate th|e FlexCa|
|00006370| 74 20 66 75 6e 63 74 69 | 6f 6e 73 20 40 73 61 6d |t functi|ons @sam|
|00006380| 70 7b 4f 70 65 6e 43 61 | 74 61 6c 6f 67 7d 20 61 |p{OpenCa|talog} a|
|00006390| 6e 64 20 40 73 61 6d 70 | 7b 43 6c 6f 73 65 43 61 |nd @samp|{CloseCa|
|000063a0| 74 61 6c 6f 67 7d 0a 66 | 72 6f 6d 20 74 68 65 20 |talog}.f|rom the |
|000063b0| 63 6f 72 72 65 73 70 6f | 6e 64 69 6e 67 20 40 63 |correspo|nding @c|
|000063c0| 6f 64 65 7b 4c 6f 63 61 | 6c 65 7d 20 66 75 6e 63 |ode{Loca|le} func|
|000063d0| 74 69 6f 6e 73 20 77 69 | 74 68 20 74 68 65 20 73 |tions wi|th the s|
|000063e0| 61 6d 65 20 6e 61 6d 65 | 73 20 61 6e 64 0a 74 6f |ame name|s and.to|
|000063f0| 20 61 6c 6c 6f 77 20 64 | 69 66 66 65 72 65 6e 74 | allow d|ifferent|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.
